Enum ClawftError 

#[non_exhaustive]
pub enum ClawftError {
    Retry {
        source: Box<dyn Error + Send + Sync>,
        attempts: u32,
    },
    Timeout {
        operation: String,
    },
    Provider {
        message: String,
    },
    RateLimited {
        retry_after_ms: u64,
    },
    ConfigInvalid {
        reason: String,
    },
    PluginLoadFailed {
        plugin: String,
    },
    Io(Error),
    Json(Error),
    Channel(String),
    SecurityViolation {
        reason: String,
    },
}

Top-level error type for the clawft framework.

Variants are grouped into recoverable (retry, timeout, rate-limit) and fatal (config, plugin, I/O) categories to guide callers on whether retrying is worthwhile.

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.

Retry

A transient failure that may succeed on retry.

Fields

source: Box<dyn Error + Send + Sync>

The underlying error.

attempts: u32

How many attempts have been made so far.

Timeout

An operation exceeded its deadline.

Fields

operation: String

Human-readable name of the operation that timed out.

Provider

A provider returned an error (e.g. bad request, server error).

Fields

message: String

Provider-supplied error message.

RateLimited

The provider is throttling requests.

Fields

retry_after_ms: u64

Suggested wait time in milliseconds before retrying.

ConfigInvalid

Configuration is malformed or semantically invalid.

Fields

reason: String

What is wrong with the configuration.

PluginLoadFailed

A plugin/extension could not be loaded.

Fields

plugin: String

Name or path of the plugin that failed.

Io(Error)

Underlying I/O error.

Json(Error)

JSON serialization / deserialization error.

Channel(String)

A channel-layer error bubbled up.

SecurityViolation

A security boundary was violated (path traversal, oversized input, etc.)

Fields

reason: String

What policy was violated.

Trait Implementations

impl Debug for ClawftError

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

Formats the value using the given formatter.

impl Display for ClawftError

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

Formats the value using the given formatter.

impl Error for ClawftError

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 ClawftError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClawftError

fn from(source: Error) -> Self

Converts to this type from the input type.