Struct CapturedOutput 

pub struct CapturedOutput { /* private fields */ }

Captured stdout/stderr from a non-interactive sandbox process.

Wraps a tempfile::TempDir that is automatically removed when the last Arc<CapturedOutput> is dropped (either from the ProcessCapture handle or from the ProcessRecord in the registry).

Implementations

impl CapturedOutput

pub fn new(mode: OutputMode) -> Result<Self>

Allocate a new output capture directory.

Errors

Returns an std::io::Error if the directory cannot be created.

pub fn stdout_path(&self) -> PathBuf

Path to the stdout output file (or combined output file).

pub fn stderr_path(&self) -> Option<PathBuf>

Path to the stderr output file, or None when streams are combined.

pub fn read_stdout(&self) -> Result<String>

Read captured stdout (or combined output) as a UTF-8 string.

Returns an empty string if the file does not yet exist (process has not produced any output).

Errors

Returns an std::io::Error if the file exists but cannot be read.

pub fn read_stderr(&self) -> Result<Option<String>>

Read captured stderr as a UTF-8 string.

Returns None when using OutputMode::Combined (use read_stdout instead). Returns an empty string if the stderr file does not yet exist.

Errors

Returns an std::io::Error if the file exists but cannot be read.

pub const fn mode(&self) -> OutputMode

The capture mode.

Trait Implementations

impl Debug for CapturedOutput

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

Formats the value using the given formatter.