Enum fun_run::CmdError

pub enum CmdError {
    SystemError(String, Error),
    NonZeroExitNotStreamed(NamedOutput),
    NonZeroExitAlreadyStreamed(NamedOutput),
}

Who says (Command) errors can’t be fun?

Fun run errors include all the info a user needs to debug, like the name of the command that failed and any outputs (like error messages in stderr).

Fun run errors don’t overwhelm end users, so by default if stderr is already streamed the output won’t be duplicated.

Enjoy if you want, skip if you don’t. Fun run errors are not mandatory.

Error output formatting is unstable

Variants

SystemError(String, Error)

NonZeroExitNotStreamed(NamedOutput)

NonZeroExitAlreadyStreamed(NamedOutput)

Implementations

impl CmdError

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

Returns a display representation of the command that failed

Example:

use fun_run::CommandWithName;
use std::process::Command;

let result = Command::new("cat")
    .arg("mouse.txt")
    .named_output();

match result {
    Ok(_) => unimplemented!(),
    Err(error) => assert_eq!(error.name().to_string(), "cat mouse.txt")
}

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<CmdError> for NamedOutput

fn from(value: CmdError) -> Self

Converts to this type from the input type.