Struct ExecutionResult 

pub struct ExecutionResult {
    pub raw_output: Vec<u8>,
    pub text_output: String,
    pub exit_code: Option<i32>,
    pub duration: Duration,
    pub timed_out: bool,
    pub total_bytes: u64,
    pub truncated: bool,
}

Result of command execution.

Fields

raw_output: Vec<u8>

Raw output from the terminal.

text_output: String

Sanitized text output (ANSI codes stripped).

exit_code: Option<i32>

Exit code (if command completed).

duration: Duration

Execution duration.

timed_out: bool

Whether execution timed out.

total_bytes: u64

Bytes the command produced, including any this result did not keep.

Counted as the output arrives rather than measured from raw_output, so it stays accurate once a cap has discarded the tail — which is the only situation where the two numbers differ, and exactly the situation a caller needs the real figure for.

truncated: bool

Whether output was discarded because it exceeded the cap.

Implementations

impl ExecutionResult

pub fn new(raw_output: Vec<u8>, text_output: String, duration: Duration) -> Self

Create a new execution result.

total_bytes is taken from raw_output and truncated is false: a result built this way kept everything it was given. The executor, which is the only place that can discard output, sets both explicitly through Self::with_output_extent.

pub fn timeout( raw_output: Vec<u8>, text_output: String, duration: Duration, ) -> Self

Create a result indicating timeout.

pub fn with_output_extent(self, total_bytes: u64, truncated: bool) -> Self

Record how much output the command actually produced.

Separate from the constructors because only the collecting loop knows the figure once a cap is in play — raw_output.len() is what was kept, not what was produced.

pub fn with_exit_code(self, code: i32) -> Self

Set the exit code.

pub fn success(&self) -> bool

Check if command succeeded (exit code 0).

pub fn failed(&self) -> bool

Check if command failed (non-zero exit code or timeout).

pub fn output_trimmed(&self) -> &str

Get output as string, trimmed.

pub fn output_lines(&self) -> impl Iterator<Item = &str>

Get output lines.

Trait Implementations

impl Clone for ExecutionResult

fn clone(&self) -> ExecutionResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecutionResult

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

Formats the value using the given formatter.

impl Default for ExecutionResult

fn default() -> Self

Returns the “default value” for a type.