Module run_package 

Constants

CAP_REGISTER_TIMEOUT 🔒

CMD_INIT_DELIVERY 🔒

POLL_INTERVAL 🔒

RBNX_INVOCATION_CWD 🔒

Directory against which relative -p is resolved: the pwd of the command invocation. When cargo run runs from robonix/rust, the process cwd is not the user’s shell cwd — wrappers should export RBNX_INVOCATION_CWD="$(pwd)" before cd+cargo run. If unset, std::env::current_dir() is used.

Functions

build_deploy_manifest 🔒

Build every package referenced by a top-level robonix_manifest.yaml. Two phases:

build_start_config_json 🔒

Materialize a per-instance config from --config <file> plus repeatable --set k.v=val overrides. Returns the merged JSON string, or None when neither input was provided.

call_driver_init 🔒

Send Driver(CMD_INIT, config_json) to a known provider’s */driver gRPC capability. Mirrors deploy.rs’s call_driver_cmd but inlined to keep run_package.rs free of cross-module coupling.

contract_id_to_service_name 🔒

robonix/primitive/chassis/move → RobonixPrimitiveChassisMove. mycomp/a/b/c → MycompABC. Uniform PascalCase per /-segment; no prefix stripping.

drive_cmd_init_after_register 🔒

Wait for the new provider (any provider not in before) to appear in atlas with a */driver gRPC capability, then call Driver(CMD_INIT, config_json). One package = one provider. Gives up after 60s; rbnx start keeps the package running regardless.

execute_build

execute_start

find_package_from_cwd 🔒

Walk up from the invocation cwd looking for a directory that contains a package_manifest.yaml. Returns the first match.

merge_dotted 🔒

Set obj[a][b][c] = v for a dotted key like "a.b.c". Creates intermediate objects as needed; bails on a non-object collision.

path_base_for_dash_p 🔒

resolve_local_path_for_filesystem 🔒

Resolve -p to a filesystem path before canonicalize: relative paths and . use path_base_for_dash_p as the prefix (invocation pwd, or process cwd).

resolve_package_path 🔒

Resolve package path from -p (local path) or -g (system-installed name). When neither is given, walk up from cwd to find a package manifest.

resolve_package_path_for_start 🔒

Resolve package path for start: same -p rules as build, then system-installed name fallback.

shell_escape 🔒

POSIX-shell single-quoted escape, used when we synthesise export FOO=... fragments to inject into a package’s start body.