Enum PluginError 

#[non_exhaustive]
pub enum PluginError {
    NotFound,
    DuplicateId,
    InUse,
    InvalidConfig(String),
    IncompatibleApiVersion {
        expected: String,
        actual: String,
    },
    Disabled,
    Cancelled,
    WallTimeExceeded,
    RequestTimeout,
    RequestAbandoned,
    InputBudgetExceeded {
        actual: usize,
        maximum: usize,
    },
    RequestBudgetExceeded,
    ResponseBodyBudgetExceeded {
        actual: u64,
        maximum: u64,
    },
    ResponseBodyBudgetUnavailable,
    CumulativeBodyBudgetExceeded,
    ObservationBudgetExceeded,
    ObservationBytesBudgetExceeded,
    ScopeViolation,
    BrokerFailure(String),
    ExecutionFailed(String),
    Panicked,
    HostCallbackPanicked,
    ContextSealed,
    ClockBeforeUnixEpoch,
    HostStateUnavailable,
}

Typed plugin-boundary failures.

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.

NotFound

Plugin identity was not registered.

DuplicateId

Plugin identity is already registered.

InUse

Plugin identity has an invocation in flight and cannot be removed.

InvalidConfig(String)

Plugin descriptor, configuration, or request was invalid.

IncompatibleApiVersion

Plugin targets another Preview API line.

Fields

expected: String

Host API line.

actual: String

Plugin API line.

Disabled

Host configuration disabled this plugin.

Cancelled

Host cancelled the invocation.

WallTimeExceeded

The invocation crossed its wall-clock budget.

RequestTimeout

One request crossed its timeout budget.

RequestAbandoned

Plugin code abandoned a polled request before the broker returned.

InputBudgetExceeded

Input exceeded the immutable request budget.

Fields

actual: usize

Actual bytes.

maximum: usize

Maximum bytes.

RequestBudgetExceeded

Request dispatch count exceeded the immutable budget.

ResponseBodyBudgetExceeded

One response exceeded its delivered-body budget.

Fields

actual: u64

Delivered bytes.

maximum: u64

Maximum bytes.

ResponseBodyBudgetUnavailable

The per-response budget grants no body-capture authority.

CumulativeBodyBudgetExceeded

Invocation-wide delivered response bytes exceeded the budget.

ObservationBudgetExceeded

Observation count exceeded the immutable budget.

ObservationBytesBudgetExceeded

Observation text exceeded the immutable byte budget.

ScopeViolation

A URL was outside the exact authorized HTTP(S) origin.

BrokerFailure(String)

The host-owned broker rejected or failed a request.

ExecutionFailed(String)

Plugin logic returned a failure.

Panicked

Plugin code panicked in a registration callback or while executing.

HostCallbackPanicked

A host-supplied plugin policy callback panicked.

ContextSealed

Observation or request authority was already sealed.

ClockBeforeUnixEpoch

System time was earlier than the Unix epoch.

HostStateUnavailable

Internal synchronized state was poisoned.

Trait Implementations

impl Clone for PluginError

fn clone(&self) -> PluginError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PluginError

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

Formats the value using the given formatter.

impl Display for PluginError

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

Formats the value using the given formatter.

impl Eq for PluginError

impl Error for PluginError

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 PartialEq for PluginError

fn eq(&self, other: &PluginError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PluginError