Enum Error 

#[non_exhaustive]
pub enum Error {
    InvalidRequest {
        reason: String,
    },
    Authentication {
        reason: String,
    },
    NotFound {
        reason: String,
    },
    Conflict {
        reason: String,
    },
    Refused {
        status: u16,
        reason: String,
    },
    SandboxEnded {
        sandbox: SandboxId,
        state: RunState,
    },
    SandboxFailed {
        sandbox: SandboxId,
        reason: String,
    },
    CommandRefused {
        number: CommandNumber,
        reason: String,
    },
    ReplayEnded {
        replay: RunId,
        state: RunState,
    },
    NoApiKey {
        api_url: String,
    },
    Credentials {
        path: PathBuf,
        problem: String,
    },
    Network {
        context: String,
        source: Option<Error>,
    },
    Unexpected(String),
}

What the SDK returns when a call fails. A command’s exit code is never one of these.

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.

InvalidRequest

400: the request isn’t one dvm.run takes, such as an image that isn’t one.

Fields

reason: String

Authentication

401: the API key was revoked, or isn’t one.

Fields

reason: String

NotFound

404: no such sandbox, command, execution or replay, or not the key’s user’s.

Fields

reason: String

Conflict

409: what was asked can’t be done in the state it’s in.

Fields

reason: String

Refused

Another refusal: its status, and dvm.run’s reason.

Fields

status: u16

reason: String

SandboxEnded

The sandbox ended (stopped, or its command exited) before the call could act on it.

Fields

sandbox: SandboxId

state: RunState

SandboxFailed

dvm or the platform ended the sandbox, and why: a syscall dvm can’t serve, a limit, its runner going away.

Fields

sandbox: SandboxId

reason: String

CommandRefused

The sandbox didn’t take the command, and why: a script in an image with no shell, a command too long.

Fields

number: CommandNumber

reason: String

ReplayEnded

A replay ended without a verdict: dvm saw it part from its execution and failed it, with where, or it was stopped.

Fields

replay: RunId

state: RunState

NoApiKey

No key was given, in DVM_API_KEY, or saved by dvm-run login.

Fields

api_url: String

Credentials

The saved keys couldn’t be read or written.

Fields

path: PathBuf

problem: String

Network

dvm.run couldn’t be reached, or the connection to it dropped.

Fields

context: String

source: Option<Error>

Unexpected(String)

dvm.run answered what the SDK can’t read.

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.