Struct CommandRequest 

pub struct CommandRequest { /* private fields */ }

A complete portable request to execute one command.

This type describes execution intent only. It does not contain a sandbox policy because policy is a separate Cageforge concern and will be composed by the backend API. It also does not expose PTY handles, inherited file descriptors, process ids, or OS-specific user/token settings.

Implementations

impl CommandRequest

pub fn new(command: CommandSpec) -> Self

Creates a request with the captured-stdio and inherited-environment defaults.

pub fn with_working_directory( self, path: impl Into<PathBuf>, ) -> Result<Self, CommandError>

Sets the working directory.

The path is kept in the caller’s native representation. Relative paths are resolved by the backend, but lexical parent traversal is rejected here so a request cannot escape its later execution context by using parent components.

pub fn without_working_directory(self) -> Self

Removes an explicitly configured working directory.

pub fn with_environment(self, environment: EnvironmentSpec) -> Self

Replaces the environment construction rules.

pub fn with_stdio(self, stdio: StdioSpec) -> Self

Replaces standard stream routing.

pub fn with_timeout(self, timeout: Duration) -> Self

Sets an explicit maximum execution duration.

pub fn with_timeout_policy(self, timeout: TimeoutPolicy) -> Self

Replaces the timeout intent with an explicit policy.

pub fn use_backend_timeout(self) -> Self

Uses the timeout selected by the backend or resolved profile.

pub fn disable_timeout(self) -> Self

Disables the automatic timeout while leaving cancellation available to the execution lifecycle.

pub fn command(&self) -> &CommandSpec

Returns the command line.

pub fn working_directory(&self) -> Option<&Path>

Returns the optional working directory.

pub fn environment(&self) -> &EnvironmentSpec

Returns environment construction rules.

pub fn stdio(&self) -> StdioSpec

Returns standard stream routing.

pub fn timeout_policy(&self) -> TimeoutPolicy

Returns the timeout intent.

Trait Implementations

impl Clone for CommandRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandRequest

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

Formats the value using the given formatter.

impl Eq for CommandRequest

impl PartialEq for CommandRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CommandRequest