Enum CliError 

pub enum CliError {
    New(NewError),
    Git(GitError),
    MissingTools(MissingTools),
    MissingChrome {
        reason: String,
    },
    NotAnApplication {
        start: PathBuf,
    },
    Config {
        path: PathBuf,
        source: Box<HostError>,
    },
    Host {
        source: Box<HostError>,
    },
    CommandFailed {
        command: String,
        status: String,
    },
    CommandSpawn {
        command: String,
        source: Error,
    },
    PageToolchainMissing {
        changed: usize,
    },
    Io {
        operation: &'static str,
        path: PathBuf,
        source: Error,
    },
    CurrentDir {
        source: Error,
    },
    Runtime {
        source: Error,
    },
    PortUnavailable {
        role: &'static str,
        key: &'static str,
        addr: SocketAddr,
        coherence: &'static str,
        source: Error,
    },
    NeverReady {
        bind: String,
        deadline: Duration,
    },
    TeardownTimeout {
        deadline: Duration,
    },
    VerdictFailed {
        verb: &'static str,
        failed: Vec<String>,
    },
    DoctorProblems {
        problems: usize,
    },
}

Typed refusal or failure from any frame verb.

Variants

New(NewError)

Scaffold generation refused or failed.

Git(GitError)

Initialising the new application’s git repository failed (a git command that ran refused — never a missing-git or already-in-a-repo condition, which frame new reports and continues past).

MissingTools(MissingTools)

A verb’s prerequisite tools are missing (with install links).

MissingChrome

The real-browser proof has no browser to drive.

Fields

reason: String

The refusal, naming the probed path and the install link.

NotAnApplication

The verb was run outside a Frame application.

Fields

start: PathBuf

Directory the search started from.

Config

The application’s frame.toml failed to load or validate.

Fields

path: PathBuf

The config file that failed.

source: Box<HostError>

The host’s own typed load failure (boxed: the host error is large, and Result should stay lean on the Ok path).

Host

frame host failed to boot or serve.

Fields

source: Box<HostError>

The host’s own typed failure (boxed as above).

CommandFailed

A build or verification command exited unsuccessfully.

Fields

command: String

The command line that failed.

status: String

Its exit status.

CommandSpawn

A command could not be spawned at all (present prerequisites were already checked, so this is an unexpected process failure, not a missing tool).

Fields

command: String

The command line that failed to start.

source: Error

The underlying process error.

PageToolchainMissing

Page sources changed but the toolchain that recompiles them is not installed, and this verb never installs anything.

Fields

changed: usize

How many sources are newer than their compiled modules.

Io

A named filesystem operation failed.

Fields

operation: &'static str

Operation that failed.

path: PathBuf

File or directory involved.

source: Error

Underlying filesystem error.

CurrentDir

The current directory could not be read.

Fields

source: Error

Underlying filesystem error.

Runtime

The async runtime backing frame run could not be built.

Fields

source: Error

Underlying runtime construction error.

PortUnavailable

An EXPLICITLY-stated frame.toml socket is already taken — named before the host even tries to bind it, with the frame.toml key that holds it and the coherence rule for changing it. Only stated addresses are probed; a portless config (no [frame].bind, no [bus]) has nothing to probe because the host prefers-and-walks / OS-assigns those ports.

Fields

role: &'static str

Which socket role is blocked (page server / bus / bus health / websocket).

key: &'static str

The frame.toml key that holds this socket’s address.

addr: SocketAddr

The address the host would have bound.

coherence: &'static str

The coherence rule to honour when moving this port.

source: Error

The underlying bind failure (address-in-use, permission, …).

NeverReady

The booted application never started accepting connections.

Fields

bind: String

The configured page-server address.

deadline: Duration

How long frame waited.

TeardownTimeout

The application ignored a stop request past the teardown deadline.

Fields

deadline: Duration

How long frame waited before killing it.

VerdictFailed

One or more scopes of a multi-part verdict failed.

Fields

verb: &'static str

The verb whose verdict failed.

failed: Vec<String>

The scopes that failed.

DoctorProblems

The doctor found problems.

Fields

problems: usize

How many problems the walkthrough found.

Trait Implementations

impl Debug for CliError

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

Formats the value using the given formatter.

impl Display for CliError

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

Formats the value using the given formatter.

impl Error for CliError

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<GitError> for CliError

fn from(source: GitError) -> Self

Converts to this type from the input type.

impl From<MissingTools> for CliError

fn from(source: MissingTools) -> Self

Converts to this type from the input type.

impl From<NewError> for CliError

fn from(source: NewError) -> Self

Converts to this type from the input type.