Enum TransportError 

pub enum TransportError {
    InvalidPath {
        path: String,
        source: ParseError,
    },
    Unreachable {
        request: RequestLabel,
        source: Error,
    },
    CredentialRejected {
        request: RequestLabel,
    },
    NotFound {
        request: RequestLabel,
    },
    RateLimited {
        request: RequestLabel,
        wait: Option<Duration>,
    },
    RateLimitWaitTooLong {
        request: RequestLabel,
        wait: Duration,
    },
    Rejected {
        request: RequestLabel,
        status: u16,
        body: String,
    },
    Unexpected {
        request: RequestLabel,
        status: u16,
        body: String,
    },
    TooManyPages {
        request: RequestLabel,
        limit: usize,
    },
    Malformed {
        request: RequestLabel,
        source: Box<DeserializeError>,
    },
}

Anything that stops a request from producing a usable answer.

Headers are never included in any variant, so a credential cannot reach a log or an error message through here.

Variants

InvalidPath

The request path does not join cleanly onto the transport base.

Fields

path: String

The path passed to the request method.

source: ParseError

The failure Url::join reported.

Unreachable

The request never reached the forge, or no answer came back.

Fields

request: RequestLabel

The method and path that were attempted.

source: Error

The underlying transport failure.

CredentialRejected

The credential is missing or invalid (401).

Fields

request: RequestLabel

The method and path that were attempted.

NotFound

The addressed resource is not there (404).

Fields

request: RequestLabel

The method and path that were attempted.

RateLimited

The forge asked the caller to slow down (429, or a 403 that carries rate limit headers).

Fields

request: RequestLabel

The method and path that were attempted.

wait: Option<Duration>

How long the forge asked the caller to wait, when it said.

RateLimitWaitTooLong

The forge asked for a longer wait than this transport honours.

Fields

request: RequestLabel

The method and path that were attempted.

wait: Duration

How long the forge asked the caller to wait.

Rejected

The forge read the request and refused it (400, 403, or 422).

Fields

request: RequestLabel

The method and path that were attempted.

status: u16

The HTTP status the forge answered with.

body: String

The response body, summarized for the error message.

Unexpected

A status this transport does not otherwise classify, including a server error (5xx) that survived every retry.

Fields

request: RequestLabel

The method and path that were attempted.

status: u16

The HTTP status the forge answered with.

body: String

The response body, summarized for the error message.

TooManyPages

A listing still had more pages after the page limit.

Fields

request: RequestLabel

The method and path of the first page.

limit: usize

The page limit that was exceeded.

Malformed

The forge answered successfully, but the body does not decode.

Fields

request: RequestLabel

The method and path that were attempted.

source: Box<DeserializeError>

The decoding failure.

Implementations

impl TransportError

pub const fn request(&self) -> Option<&RequestLabel>

The request that failed, when the failure belongs to one.

pub const fn retry_after(&self) -> Option<Duration>

The wait the forge asked for before a retry.

pub const fn is_uncertain(&self) -> bool

Whether the forge may or may not have applied the request.

That is a connection failure or a 5xx answer.

pub const fn status(&self) -> Option<u16>

The HTTP status of a failure that carries one.

fn from_status( request: RequestLabel, status: u16, body: String, wait: Option<Duration>, ) -> Self

Map a status, body, and the wait its headers ask for to the failure class it represents.

Trait Implementations

impl Debug for TransportError

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

Formats the value using the given formatter.

impl Display for TransportError

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

Formats the value using the given formatter.

impl Error for TransportError

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.