Struct RunningCommand 

pub struct RunningCommand { /* private fields */ }

Live child process with optional piped stdio.

Implementations

impl RunningCommand

pub fn from_system( child: Child, stdin: Option<ChildStdin>, stdout: Option<ChildStdout>, stderr: Option<ChildStderr>, kill_process_group: bool, ) -> Self

Build a handle from a spawned OS child and taken stdio pipes.

pub fn from_recording( exit: CommandExit, stdout: Option<Vec<u8>>, stderr: Vec<u8>, piped_stdin: bool, ) -> Self

Build a synthetic handle for tests and custom CommandRunner implementations.

pub fn stdin_mut(&mut self) -> Option<&mut dyn Write>

Writable stdin when the spec requested a pipe.

pub fn close_stdin(&mut self)

Close the stdin pipe so the child sees EOF (required after writing hook/filter stdin).

pub fn child_pid(&self) -> Option<u32>

OS pid when this handle wraps a live child; None for synthetic recording handles.

pub fn try_wait(&mut self) -> Result<Option<CommandExit>>

Poll whether the child has exited without blocking.

Errors

Returns I/O errors from Child::try_wait.

pub fn kill(&mut self) -> Result<()>

Send SIGKILL to a live child (Unix) or terminate it (Windows).

Errors

Returns I/O errors from Child::kill.

pub fn wait(self) -> Result<CommandExit>

Wait for the child and return its exit status.

Errors

Returns I/O errors from Child::wait.

pub fn wait_with_output(self) -> Result<CommandOutput>

Wait and collect piped stdout/stderr.

Errors

Returns I/O errors from Child::wait_with_output.

pub fn into_system_parts( self, ) -> Result<(Child, Option<ChildStdin>, Option<ChildStdout>, Option<ChildStderr>), CommandHandleError>

Split into OS child and taken stdio (system runner only).

Errors

Returns CommandHandleError when the handle is not backed by a live process.