RobotWebTools / rclnodejs / 25727559523

85%

push

github

[Web Runtime] rclnodejs-web CLI launcher (#1513)

Adds the bundled `rclnodejs-web` (and `rcl-web` short alias) CLI so frontend developers can run the Web Runtime without writing a Node.js server.

- `bin/rclnodejs-web.js` (new, 138 LOC) — declarative launcher. Reads a JSON config (`web.json`) and/or repeatable `--call` / `--publish` / `--subscribe` flags. Always starts the WebSocket transport; opt-in HTTP via `--http-port` (or an `http: { port }` block in the config file). Defers `require('rclnodejs')` until after argv parsing so `--help` / `--version` stay fast. Supports ephemeral `--port 0` / `--http-port 0` for tests. Handles SIGINT/SIGTERM with `runtime.stop()` + `rclnodejs.shutdown()`.

- `lib/runtime/cli-config.js` (new, 339 LOC) — pure-data argv parser + JSON config loader + validator + defaults merger. Independent of rclnodejs so it can be unit-tested without spinning up a node. Exports `DEFAULTS`, `parseArgv`, `loadConfigFile`, `validateConfig`, `mergeConfig`, `CliError`, `HELP`. Defaults: `port=9000`, `host='::'` (dual-stack), `path='/capability'`, `node='rclnodejs_web'`, `http.port=null` (disabled).

- `test/test-web-cli.js` (new, 459 LOC) — 25 mocha cases: parseArgv (8), config-file load + validate including the `http` block (10), mergeConfig precedence (5), and end-to-end CLI launches that probe the runtime via raw WebSocket and HTTP `fetch` (3).

- `package.json` — two `bin` entries: `rclnodejs-web` (canonical) and `rcl-web` (short alias).

Fix: #1510

1828 of 2323 branches covered (78.69%)

Branch coverage included in aggregate %.

103 of 115 new or added lines in 1 file covered. (89.57%)

3609 of 4038 relevant lines covered (89.38%)

396.38 hits per line