Enum Error 

#[non_exhaustive]
pub enum Error {
    Manifest {
        path: PathBuf,
        source: Error,
    },
    Unsupported {
        what: String,
    },
    Io {
        path: PathBuf,
        action: &'static str,
        source: Error,
    },
    Locked {
        run: String,
    },
    ToolMissing {
        step: String,
        tool: String,
    },
    ToolTooOld {
        tool: String,
        found: String,
        required: String,
    },
    ToolFailed {
        step: String,
        reason: String,
    },
    Timeout {
        step: String,
        after_s: u64,
    },
    AlreadyRunning {
        run: String,
    },
    RunningElsewhere {
        run: String,
        recorded: String,
        asked: String,
    },
    PortInUse {
        port: u16,
        protocol: &'static str,
    },
    NotParkable {
        run: String,
        mode: &'static str,
    },
    NothingToResume {
        run: String,
    },
    NotRunning {
        run: String,
    },
    NotReady {
        condition: String,
        detail: String,
    },
    SecretMissing {
        name: String,
    },
    Param {
        name: String,
        reason: String,
    },
    Unbound {
        at: String,
        placeholder: String,
    },
    MachineUnknown {
        run: String,
        machine: String,
    },
    Elevation {
        reason: String,
    },
    Provider {
        provider: String,
        reason: String,
    },
    SlotsFull {
        place: String,
        held: usize,
    },
    Unreachable {
        step: String,
        login: String,
        after_s: u64,
        reason: String,
    },
    Unsealed {
        run: String,
        reason: String,
    },
    Adopt {
        run: String,
        reason: String,
    },
    RunName {
        value: String,
    },
}

Why an operation of the runner failed.

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.

Manifest

The manifest was refused (its own error names the field and the fix).

Fields

path: PathBuf

The manifest’s file.

source: Error

Why, with Isoloom’s stable code (source.code()).

Unsupported

The manifest needs something this runner doesn’t do yet.

Fields

what: String

What, as the manifest names it (driver vagrant, delivery tf_var).

Io

A file or folder couldn’t be read or written.

Fields

path: PathBuf

The file or folder.

action: &'static str

What was done to it (read, written, created, locked).

source: Error

The OS’s reason.

Locked

Another process holds the run’s lock.

Fields

run: String

The run.

ToolMissing

A step’s tool isn’t on PATH.

Fields

step: String

The step.

tool: String

The tool.

ToolTooOld

A tool answers at a version older than the manifest’s min_version for it.

Fields

tool: String

The tool.

found: String

The version it answered with.

required: String

The oldest version the run takes.

ToolFailed

A step’s tool ran and failed.

Fields

step: String

The step.

reason: String

Its last error lines, or its exit status (secrets masked).

Timeout

A step ran out of time.

Fields

step: String

The step.

after_s: u64

Its limit, in seconds.

AlreadyRunning

The run is already up.

Fields

run: String

The run.

RunningElsewhere

The run is recorded somewhere else.

Fields

run: String

The run.

recorded: String

Where its record says it is.

asked: String

Where this operation was asked to run.

PortInUse

A host port the run publishes is taken.

Fields

port: u16

The port.

protocol: &'static str

tcp or udp.

NotParkable

No park steps for that mode.

Fields

run: String

The run.

mode: &'static str

The mode asked for.

NothingToResume

Nothing left to resume.

Fields

run: String

The run.

NotRunning

The run isn’t up.

Fields

run: String

The run.

NotReady

A ready condition didn’t hold.

Fields

condition: String

The condition (step_ok up, tcp 127.0.0.1:8080).

detail: String

Why.

SecretMissing

A required secret or input has no value.

Fields

name: String

The slot.

Param

A param that can’t be used as given.

Fields

name: String

The param.

reason: String

Why.

Unbound

A placeholder with no value at run time.

Fields

at: String

Where (lifecycle.up.up).

placeholder: String

The placeholder.

MachineUnknown

A machine the run doesn’t have (to provision).

Fields

run: String

The run.

machine: String

The machine asked for.

Elevation

The elevation the run’s commands need couldn’t be had.

Fields

reason: String

Why (the permission prompt declined, the elevated session ended).

Provider

The run’s Vagrant provider can’t run it.

Fields

provider: String

The provider asked for (empty when none was).

reason: String

Why it can’t run the run, and what to do.

SlotsFull

Every slot of the run’s place is held by another run.

Fields

place: String

The place (the embedder’s label for it, or this host).

held: usize

How many runs hold a slot there.

Unreachable

A machine a step goes to over SSH never answered within the step’s wait_s.

Fields

step: String

The step.

login: String

The login it tried (user@host).

after_s: u64

How long it tried, in seconds.

reason: String

ssh’s last word.

Unsealed

The run’s seal failed: it is up, unsealed, and never reported ready.

Fields

run: String

The run.

reason: String

Why the seal failed.

Adopt

A deployment that can’t be taken over as a run.

Fields

run: String

The run it would have become.

reason: String

Why.

RunName

A run name that can’t name a run.

Fields

value: String

The name as given.

Implementations

impl Error

pub fn code(&self) -> ErrorCode

The failure’s stable code.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.