Struct SpawnCommandRequest 

pub struct SpawnCommandRequest {
    pub command: String,
    pub cwd: Option<PathBuf>,
    pub env: Vec<(String, String)>,
    pub originator: Option<String>,
    pub clear_inherited_env: bool,
}

Request to spawn a detached daemonized shell command under daemon control.

Fields

command: String

Shell command line to execute.

cwd: Option<PathBuf>

Working directory for the spawned command.

env: Vec<(String, String)>

Environment key/value pairs sent with the request.

originator: Option<String>

Caller-provided originator used for tracking and filtering.

clear_inherited_env: bool

When true, the daemon clears the inherited env before applying Self::env, so the subprocess sees ONLY the supplied map. Mirrors Python’s subprocess.Popen(env=…) replace semantic. Default false keeps the historic “layer on top of inherited” behaviour.

Implementations

impl SpawnCommandRequest

pub fn shell(command: impl Into<String>) -> Self

Build a shell-command request using the caller’s current working directory and environment.

pub fn with_cwd(self, cwd: impl Into<PathBuf>) -> Self

Override the working directory used for the spawned command.

pub fn with_envs<I, K, V>(self, env: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Replace the environment block sent to the daemon (layered on top of the daemon’s inherited env, unless Self::with_env_replace is used instead).

pub fn with_env_replace<I, K, V>(self, env: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Set the env block AND tell the daemon to clear the inherited env first — the subprocess will see ONLY the supplied map.

Mirrors Python’s subprocess.Popen(env=…) semantic:

subprocess.Popen(["..."], env=None)        # inherits
subprocess.Popen(["..."], env={"K": "V"})  # replaces

On Windows you typically still want to include SystemRoot in the supplied map so cmd.exe can load its DLLs.

pub fn with_env(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add or replace a single environment variable while keeping the rest of the existing environment block intact.

pub fn with_originator(self, originator: impl Into<String>) -> Self

Set the originator value stored in the daemon registry and injected into the spawned child environment.

Trait Implementations

impl Clone for SpawnCommandRequest

fn clone(&self) -> SpawnCommandRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SpawnCommandRequest

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

Formats the value using the given formatter.