Struct ChildEnvironment 

pub struct ChildEnvironment { /* private fields */ }

The complete environment one harness child is launched with.

“Complete” is the whole point: a spawner applying this clears the child’s environment first, so Self::pairs is not an overlay on an inherited set — it IS the set.

Implementations

impl ChildEnvironment

pub fn pairs(&self) -> &[(String, String)]

The resolved (name, value) pairs — the child’s entire environment.

pub fn declared(&self) -> &[String]

Every name the declaration carried, in declaration order.

pub fn absent(&self) -> &[String]

The declared names that the launching context did not carry, so a launcher can report them rather than let a silently-absent credential surface as an agent failure three layers down.

pub fn carries(&self, name: &str) -> bool

Whether name is carried into the child.

pub fn require_for_program( &self, program: &Path, ) -> Result<(), EnvironmentError>

Refuses the launch when program cannot be executed under this environment, naming the variable that is missing.

The one mechanically decidable case is program lookup: a program written without a path separator is resolved on PATH, and a child with no PATH cannot resolve it. An absolute or relative path needs no lookup and is not gated here — the operator’s hermetic, PATH-free declaration is legitimate and stays legitimate.

Errors

Returns EnvironmentError::MissingForExec naming PATH when program needs a lookup this environment cannot perform.

Trait Implementations

impl Clone for ChildEnvironment

fn clone(&self) -> ChildEnvironment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChildEnvironment

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

Formats the value using the given formatter.

impl Eq for ChildEnvironment

impl PartialEq for ChildEnvironment

fn eq(&self, other: &ChildEnvironment) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ChildEnvironment