Enum CliError 

pub enum CliError {
    Usage(String),
    StartIcp(Error),
    Icp {
        status: String,
        message: String,
    },
    Encode {
        method: &'static str,
        source: Error,
    },
    Decode {
        method: &'static str,
        source: Error,
    },
    RawReply(&'static str),
    Canister {
        method: &'static str,
        error: String,
    },
    Json(Error),
    Io(Error),
    PaginationStalled(String),
    PaginationLimit(usize),
}

Failure reported by CLI parsing, the ICP process boundary, or the typed canister protocol.

Variants

Usage(String)

Command-line arguments did not describe a valid operation.

StartIcp(Error)

The ICP CLI process could not be started.

Icp

The ICP CLI process reported a failed call.

Fields

status: String

Numeric process exit status, when the platform supplied one.

message: String

Bounded diagnostic written by the ICP CLI.

Encode

Typed Candid argument encoding failed before the process was started.

Fields

method: &'static str

Canister method being prepared.

source: Error

Candid codec failure.

Decode

The canister reply was not valid for the shared interface type.

Fields

method: &'static str

Canister method whose reply was being decoded.

source: Error

Candid codec failure.

RawReply(&'static str)

The ICP CLI returned something other than one bounded hexadecimal reply.

Canister

A typed application error was returned by the canister.

Fields

method: &'static str

Called canister method.

error: String

Credential-free bounded application error.

Json(Error)

JSON rendering failed.

Io(Error)

Writing the final report failed.

PaginationStalled(String)

A canister returned a continuation that had already been observed.

PaginationLimit(usize)

Automatic pagination reached its operator-provided safety bound.

Implementations

impl CliError

pub const fn exit_code(&self) -> i32

Shell exit status for this failure category.

pub fn is_broken_pipe(&self) -> bool

Whether a downstream pipeline closed standard output intentionally.

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

fn from(source: Error) -> Self

Converts to this type from the input type.