Enum AttemptError 

pub enum AttemptError {
    Transport(String),
    Status5xx {
        code: u16,
        body: String,
    },
    Timeout(Duration),
    NonRetryable(String),
}

A classification of one attempt’s failure.

Transport, Status5xx, and Timeout are retryable — the failover loop moves to the next provider. NonRetryable aborts the loop and is returned to the caller wrapped in the outcome.

Variants

Transport(String)

Network-level failure before/while receiving a response. Examples: DNS resolution failure, connection refused, TLS error, socket reset mid-stream. String is a short human description suitable for audit.

Status5xx

Provider returned a 5xx response. Carries the actual status code (e.g. 502, 503, 504) and a short body excerpt.

Fields

code: u16

body: String

Timeout(Duration)

Per-request deadline elapsed before completion.

NonRetryable(String)

Authoritative error that must NOT trigger failover. Examples: 4xx auth failure (wrong API key), 4xx quota exhausted on the account level, content-policy refusal, malformed response we cannot recover from. The kernel returns immediately when it sees this — there is no value in asking another provider when the request itself is bad.

Implementations

impl AttemptError

pub fn is_retryable(&self) -> bool

Whether this error should trigger advancement to the next provider.

Trait Implementations

impl Clone for AttemptError

fn clone(&self) -> AttemptError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttemptError

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

Formats the value using the given formatter.

impl Display for AttemptError

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

Formats the value using the given formatter.

impl PartialEq for AttemptError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AttemptError