Enum CmdError 

pub enum CmdError {
    NotFound(String),
    Failed {
        code: i32,
        stderr: String,
    },
    Io(Error),
}

Error type for shell command execution failures.

Variants

• NotFound: The command executable was not found on the system PATH. Contains the command string that was attempted.
• Failed: The command executed but exited with a non-zero status code. Contains the exit code and captured stderr output.
• Io: The process failed to spawn (e.g., permission denied, fork failure). Wraps std::io::Error for ergonomic ? propagation.

Invariants

• NotFound is distinct from Failed: a missing binary vs. a binary that ran and returned an error.
• Failed always carries both the exit code and stderr — callers can inspect either for retry decisions.
• Io wraps std::io::Error via From for ergonomic ? propagation from Command::output().

Errors

This enum IS the error type — no separate error channel exists. run_cmd returns Result<String, CmdError>.

Variants

NotFound(String)

Command executable not found on the system PATH.

The string value is the command that was attempted.

Failed

Command executed but exited with a non-zero status code.

code is the process exit code (always non-negative on Unix). stderr is the captured standard error output, trimmed.

Fields

code: i32

The non-zero exit code from the command.

stderr: String

The trimmed stderr output from the command.

Io(Error)

Process failed to spawn.

Wraps std::io::Error from Command::output(). Common causes: permission denied, resource limit reached, fork failure.

Trait Implementations

impl Debug for CmdError

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

Formats the value using the given formatter.

impl Display for CmdError

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

Formats the value using the given formatter.

impl Error for CmdError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for CmdError

fn from(source: Error) -> Self

Converts to this type from the input type.