Struct cargo_util::ProcessError

pub struct ProcessError {
    pub desc: String,
    pub code: Option<i32>,
    pub stdout: Option<Vec<u8>>,
    pub stderr: Option<Vec<u8>>,
}

Fields

desc: String

A detailed description to show to the user why the process failed.

code: Option<i32>

The exit status of the process.

This can be None if the process failed to launch (like process not found) or if the exit status wasn’t a code but was instead something like termination via a signal.

stdout: Option<Vec<u8>>

The stdout from the process.

This can be None if the process failed to launch, or the output was not captured.

stderr: Option<Vec<u8>>

The stderr from the process.

This can be None if the process failed to launch, or the output was not captured.

Implementations

impl ProcessError

pub fn new(
    msg: &str,
    status: Option<ExitStatus>,
    output: Option<&Output>
) -> ProcessError

Creates a new ProcessError.

• status can be None if the process did not launch.
• output can be None if the process did not launch, or output was not captured.

pub fn new_raw(
    msg: &str,
    code: Option<i32>,
    status: &str,
    stdout: Option<&[u8]>,
    stderr: Option<&[u8]>
) -> ProcessError

Creates a new ProcessError with the raw output data.

• code can be None for situations like being killed by a signal on unix.

pub fn could_not_execute(cmd: impl Display) -> ProcessError

Creates a ProcessError with “could not execute process {cmd}”.

• cmd is usually but not limited to std::process::Command.

Trait Implementations

impl Debug for ProcessError

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

Formats the value using the given formatter.

impl Display for ProcessError

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

Formats the value using the given formatter.

impl Error for ProcessError

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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