Enum RunProcessError 

#[non_exhaustive]
pub enum RunProcessError {
    #[non_exhaustive]
    CancelledRun {
        invocation: Invocation,
    },
    #[non_exhaustive]
    UnrunnableCommand {
        source: RunCommandError,
    },
    #[non_exhaustive]
    UnreportableOutput {
        invocation: Invocation,
        source: SendError,
    },
}

The error returned when a command cannot run an external program

The variants separate what a caller does about the failure. A command that was cancelled stops, a command whose program never ran reports the program, and a command whose output can no longer be reported has lost its presenter and ends.

A program that ran and ended without success is no failure of the run. The Execution then carries the status, and require_success turns a status that the caller cannot accept into an error of its own.

A later release can add variants, and it can add fields to a variant. Match with a wildcard arm, and bind the fields of a variant with ...

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

#[non_exhaustive]

CancelledRun

Cancellation stopped the program before it ended

Clawless killed the program, so the run has no exit status and no complete output. A command that treats cancellation as an orderly end matches this variant and returns without an error.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

invocation: Invocation

The command that was cancelled

#[non_exhaustive]

UnrunnableCommand

The program could not be run

No program answers to the name, the working directory does not exist, the operating system refused to start the program, or the run started and its result could not be collected. The message is the one of the underlying failure, because this layer knows nothing that the run does not already state.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: RunCommandError

The cause of the failure

#[non_exhaustive]

UnreportableOutput

The output of the program could not be reported

The presenter stopped listening while the program ran, so the run has no consumer left. The program itself was killed with the run.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

invocation: Invocation

The command whose output could not be reported

source: SendError

The cause of the failure

Trait Implementations

impl Debug for RunProcessError

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

Formats the value using the given formatter.

impl Display for RunProcessError

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

Formats the value using the given formatter.

impl Error for RunProcessError

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.