Struct LaunchPlan 

pub struct LaunchPlan {
    pub mounts: Vec<Mount>,
    pub env_literal: Vec<(String, String)>,
    pub env_passthrough: Vec<String>,
    pub args: Vec<String>,
    pub cap_add: Vec<String>,
}

All caller-controlled variable parts of a container run invocation.

Session::start builds the fixed base flags and the workspace mount internally, then appends everything in this struct.

Assemble with LaunchPlan::default() and fill fields as needed, or collect them via run_package.

Fields

mounts: Vec<Mount>

Extra bind-mounts beyond the session workspace.

Each entry becomes a -v host:container:mode argument. Paths must already be canonical absolute host paths.

env_literal: Vec<(String, String)>

Literal environment variables injected into the container.

Each (K, V) pair becomes a -e K=V argument.

env_passthrough: Vec<String>

Environment variable names forwarded from npxc’s own process environment. Each name becomes a bare -e K argument; the container runtime inherits the value from npxc’s environment at launch time. Secrets never touch the npxc config file when this mechanism is used.

args: Vec<String>

Arguments appended after the image tag.

These are forwarded verbatim to the container’s entrypoint.

cap_add: Vec<String>

Linux capabilities to add back on top of --cap-drop ALL.

Each entry becomes a --cap-add <CAP> argument. Used by tunnel mode to grant NET_ADMIN so the entrypoint can configure wg0.

Implementations

impl LaunchPlan

pub fn build( pkg_name: &str, effective: &EffectiveConfig, cwd: &Path, args: Vec<String>, no_isolate: bool, ) -> Result<Self, NpxcError>

Assemble a LaunchPlan from the resolved package configuration.

Steps, in order:

1. Populate env_literal and env_passthrough from effective.
2. Store args verbatim.
3. Validate and add each config-declared directory mount. Relative host paths are resolved against cwd; every path is checked to lie within the CWD scope via validate_path.
4. When effective.storage.persist is set, create the per-package host directory under the platform data dir and add a read-write mount at /data.
5. --no-isolate — when no_isolate is true, append a read-only bind-mount of the canonicalized CWD at its own absolute path so host paths resolve identically inside the guest.

Errors

Returns NpxcError::PathOutOfScope or NpxcError::PathNotFound if a config-declared mount path fails CWD validation, or NpxcError::Io if the persistent storage directory cannot be created.

Trait Implementations

impl Debug for LaunchPlan

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LaunchPlan

fn default() -> LaunchPlan

Returns the “default value” for a type.