Struct CommandRunner 

pub struct CommandRunner { /* private fields */ }

Runs external commands and captures their output.

CommandRunner runs one Command synchronously on the caller thread and returns captured process output. The runner always preserves raw output bytes. Its lossy-output option controls whether CommandOutput::stdout and CommandOutput::stderr reject invalid UTF-8 or return replacement characters.

Author

Haixing Hu

Implementations

impl CommandRunner

pub fn new() -> Self

Creates a command runner with default settings.

Returns

A runner with a 10-second timeout, inherited working directory, success exit code 0, and strict UTF-8 output text accessors.

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

Sets the command timeout.

Parameters

• timeout - Maximum duration allowed for each command.

Returns

The updated command runner.

pub const fn without_timeout(self) -> Self

Disables timeout handling.

Returns

The updated command runner.

pub fn working_directory<P>(self, working_directory: P) -> Self

where P: Into<PathBuf>,

Sets the default working directory.

Parameters

• working_directory - Directory used when a command has no per-command working directory override.

Returns

The updated command runner.

pub fn success_exit_code(self, exit_code: i32) -> Self

Sets the only exit code treated as successful.

Parameters

• exit_code - Exit code considered successful.

Returns

The updated command runner.

pub fn success_exit_codes(self, exit_codes: &[i32]) -> Self

Sets all exit codes treated as successful.

Parameters

• exit_codes - Exit codes considered successful.

Returns

The updated command runner.

pub const fn disable_logging(self, disable_logging: bool) -> Self

Enables or disables command execution logs.

Parameters

• disable_logging - true to suppress runner logs.

Returns

The updated command runner.

pub const fn lossy_output(self, lossy_output: bool) -> Self

Configures whether output text accessors use lossy UTF-8 conversion.

Parameters

• lossy_output - true to replace invalid UTF-8 bytes with the Unicode replacement character when CommandOutput::stdout or CommandOutput::stderr is called.

Returns

The updated command runner.

pub const fn configured_timeout(&self) -> Option<Duration>

Returns the configured timeout.

Returns

Some(duration) when timeout handling is enabled, otherwise None.

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

Returns the default working directory.

Returns

Some(path) when a default working directory is configured, otherwise None to inherit the current process working directory.

pub fn configured_success_exit_codes(&self) -> &[i32]

Returns the configured successful exit codes.

Returns

Borrowed list of exit codes treated as successful.

pub const fn is_logging_disabled(&self) -> bool

Returns whether logging is disabled.

Returns

true when runner logs are disabled.

pub const fn is_lossy_output_enabled(&self) -> bool

Returns whether output text accessors use lossy UTF-8 conversion.

Returns

true when invalid UTF-8 bytes are replaced before output is returned by CommandOutput::stdout or CommandOutput::stderr.

pub fn run(&self, command: Command) -> Result<CommandOutput, CommandError>

Runs a command and captures stdout and stderr.

This method blocks the caller thread until the child process exits or the configured timeout is reached. Captured output is always retained as raw bytes. If lossy output mode is enabled, invalid UTF-8 is replaced only for CommandOutput::stdout and CommandOutput::stderr; byte accessors still return the original process output.

Parameters

• command - Structured command to run.

Returns

Captured output when the process exits with a configured success code.

Errors

Returns CommandError if the process cannot be spawned, cannot be waited on, times out, cannot be killed after timing out, emits output that cannot be read, or exits with a code not configured as successful.

Trait Implementations

impl Clone for CommandRunner

fn clone(&self) -> CommandRunner

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandRunner

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

Formats the value using the given formatter.

impl Default for CommandRunner

fn default() -> Self

Creates a command runner with the default timeout and exit-code policy.

Returns

A runner with a 10-second timeout, inherited working directory, success exit code 0, and strict UTF-8 output text accessors.

impl PartialEq for CommandRunner

fn eq(&self, other: &CommandRunner) -> 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 CommandRunner

impl StructuralPartialEq for CommandRunner