Enum Error 

enum Error {
    WorkerStopped,
    Method(Method),
    HeaderName(HeaderName),
    HeaderValue(HeaderName),
    HttpNotAllowed(Uri),
    Transport {
        kind: HttpErrorKind,
        message: String,
    },
    ResponseBody(String),
    IncompleteBody {
        expected: u64,
        received: u64,
    },
    UnexpectedTransferEncoding,
    ReadTimeout,
    HeadTimeout,
    Response(Error),
}

Something that went wrong relaying a request through awc.

Variants

WorkerStopped

Method(Method)

HeaderName(HeaderName)

HeaderValue(HeaderName)

HttpNotAllowed(Uri)

Transport

Fields

kind: HttpErrorKind

message: String

ResponseBody(String)

IncompleteBody

The remote under-delivered: awc ended the stream cleanly but fewer bytes arrived than the response’s Content-Length (a premature close awc reports as a clean EOF).

Fields

expected: u64

received: u64

UnexpectedTransferEncoding

ReadTimeout

HeadTimeout

Response(Error)

Implementations

impl Error

fn classify_send_error(err: &SendRequestError) -> HttpErrorKind

Maps an awc transport error to the object_store osc::HttpErrorKind that best describes it. object_store’s retry loop — not this function — then decides retryability from that kind: it retries Connect/Request unconditionally, Timeout/Interrupted only for idempotent requests, and never Decode/Unknown (https://github.com/apache/arrow-rs-object-store/blob/6c5b299d4274219ecd406cc4828b94efe4a14f8d/src/client/retry.rs#L394-L399). We pick each kind so that decision matches what object_store’s own reqwest connector (HttpError::reqwest) would produce for the equivalent failure.

fn classify_parse_error(err: &ParseError) -> HttpErrorKind

Maps a response-head ParseError to the object_store kind. awc surfaces a connection lost while the head is being received as a ParseError rather than a Send/Connect error, so we treat those transport variants as retryable (matching reqwest) and only a structurally invalid head as a non-retryable decode error.

fn classify_io_error(err: &Error) -> HttpErrorKind

Maps an I/O error by matching std::io::Error::kind(), the same conversion object_store’s reqwest connector applies when it finds a std::io::Error in the error source chain (HttpError::reqwest): https://github.com/apache/arrow-rs-object-store/blob/6c5b299d4274219ecd406cc4828b94efe4a14f8d/src/client/http/connection.rs#L122-L132

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<SendRequestError> for Error

fn from(err: SendRequestError) -> Self

Wraps an awc send error, classifying it into the object_store osc::HttpErrorKind up front (the error itself is !Sync and can’t be carried, so we keep only its message).