Struct CommandOutput 

pub struct CommandOutput { /* private fields */ }

Captured output and status information from a finished command.

CommandOutput stores retained raw stdout and stderr bytes. When the runner is configured with per-stream capture limits, the retained bytes may be a prefix of the full output; use Self::stdout_truncated and Self::stderr_truncated to detect that case. Self::stdout and Self::stderr return raw bytes exactly as retained. Use Self::stdout_text and Self::stderr_text for strict UTF-8 text, or Self::stdout_lossy_text and Self::stderr_lossy_text to replace invalid byte sequences with the Unicode replacement character.

Implementations

impl CommandOutput

pub fn exit_code(&self) -> Option<i32>

Returns the command exit code.

Returns

Some(code) when the platform reports a numeric process exit code, or None when the process ended in a way that does not map to a numeric code.

pub const fn exit_status(&self) -> &ExitStatus

Returns the full process exit status.

Returns

Platform-specific process exit status reported by the operating system.

pub fn termination_signal(&self) -> Option<i32>

Returns the signal that terminated the process on Unix platforms.

Returns

Some(signal) when the process was terminated by a signal, otherwise None.

pub fn stdout(&self) -> &[u8]

Returns captured standard output bytes.

Returns

A borrowed slice containing stdout exactly as emitted by the process.

pub fn stderr(&self) -> &[u8]

Returns captured standard error bytes.

Returns

A borrowed slice containing stderr exactly as emitted by the process.

pub fn stdout_text(&self) -> Result<&str, Utf8Error>

Returns captured standard output as strict UTF-8 text.

Returns

Ok(&str) when stdout is valid UTF-8.

Errors

Returns str::Utf8Error when stdout contains invalid UTF-8.

pub fn stderr_text(&self) -> Result<&str, Utf8Error>

Returns captured standard error as strict UTF-8 text.

Returns

Ok(&str) when stderr is valid UTF-8.

Errors

Returns str::Utf8Error when stderr contains invalid UTF-8.

pub fn stdout_lossy_text(&self) -> Cow<'_, str>

Returns captured standard output as UTF-8 text, replacing invalid bytes.

Returns

Borrowed UTF-8 text when stdout is valid UTF-8, or an owned string with invalid byte sequences replaced by the Unicode replacement character.

pub fn stderr_lossy_text(&self) -> Cow<'_, str>

Returns captured standard error as UTF-8 text, replacing invalid bytes.

Returns

Borrowed UTF-8 text when stderr is valid UTF-8, or an owned string with invalid byte sequences replaced by the Unicode replacement character.

pub const fn elapsed(&self) -> Duration

Returns the observed command duration.

Returns

Duration from process spawn to observed termination.

pub const fn stdout_truncated(&self) -> bool

Returns whether captured stdout was truncated by a configured limit.

Returns

true when stdout emitted more bytes than the runner retained.

pub const fn stderr_truncated(&self) -> bool

Returns whether captured stderr was truncated by a configured limit.

Returns

true when stderr emitted more bytes than the runner retained.

Trait Implementations

impl Clone for CommandOutput

fn clone(&self) -> CommandOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandOutput

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

Formats the value using the given formatter.

impl PartialEq for CommandOutput

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CommandOutput

impl StructuralPartialEq for CommandOutput