Enum LaunchError 

#[non_exhaustive]
pub enum LaunchError {
    NoProgram,
    NotFound {
        program: String,
    },
    PermissionDenied {
        program: String,
    },
    NoExecFormat {
        program: String,
    },
    InvalidKey {
        key: String,
        source: KeyNameError,
    },
    Guard(GuardError),
    CommandLine(CmdLineError),
    Io {
        program: String,
        source: Error,
    },
}

A launch that did not happen.

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.

NoProgram

No program was given.

NotFound

The program does not exist on PATH.

Fields

program: String

The program as the user wrote it.

PermissionDenied

The program exists but is not executable by this user.

Fields

program: String

The resolved program path.

NoExecFormat

The file exists and is executable but is not a program image.

Almost always a script whose shebang line is missing, misspelled, or carries a CRLF line ending that makes the interpreter path unresolvable.

Fields

program: String

The resolved program path.

InvalidKey

A secret’s name is not usable as an environment variable.

Fields

key: String

The offending name.

source: KeyNameError

Why it was rejected.

Guard(GuardError)

A secret’s name is one the loader or a language runtime interprets.

CommandLine(CmdLineError)

An argument cannot be carried through cmd.exe to a batch shim.

Io

The launch failed for a reason the operating system reported.

Fields

program: String

The program that was being launched.

source: Error

The underlying failure.

Implementations

impl LaunchError

pub fn exit_code(&self) -> i32

The status prk should exit with for this failure.

pub fn hint(&self) -> Option<&'static str>

The actionable next step, for the structured help channel.

pub fn from_io(program: &OsStr, source: Error) -> Self

Classifies an io::Error from a failed launch.

The three interesting cases each have a distinct exit code and a distinct fix, and all three arrive as the same io::Error type.

Trait Implementations

impl Debug for LaunchError

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

Formats the value using the given formatter.

impl Display for LaunchError

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

Formats the value using the given formatter.

impl Error for LaunchError

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<CmdLineError> for LaunchError

fn from(source: CmdLineError) -> Self

Converts to this type from the input type.

impl From<GuardError> for LaunchError

fn from(source: GuardError) -> Self

Converts to this type from the input type.