Struct TransportError 

pub struct TransportError(/* private fields */);

An HTTP transport failure.

An opaque wrapper rather than reqwest::Error itself, and that is the whole point of it. reqwest is a 0.x crate, so under cargo’s rules 0.13 → 0.14 is a breaking change — and a reqwest::Error in this crate’s public API would make every such bump a breaking change here, for a dependency that has nothing to do with Alpaca. Callers on 0.1.x would be pinned to reqwest 0.13 for the life of the line.

This crate already re-exports polars and crate::rust_decimal with two paragraphs each explaining why a version-skewed type is worth avoiding. reqwest got neither; now it does not need one.

The reqwest::Error is deliberately not reachable — an accessor would put the type back in the public API and undo the point of the wrapper. What a caller actually asks of a transport error is answered by the predicates below, and std::error::Error::source continues the chain past this layer into reqwest’s own cause (the hyper or TLS error underneath), which is the part that carries information this type does not already forward.

If you need a predicate that is not here, open an issue rather than reaching through: adding one is cheap and keeps the dependency contained.

Implementations

impl TransportError

pub fn is_timeout(&self) -> bool

Whether the failure was a timeout.

A timeout says nothing about whether the server acted on the request: see Error::is_transient before using this to decide on a retry.

pub fn is_connect(&self) -> bool

Whether the connection was never established.

The one transport failure that guarantees the request was not processed.

pub fn is_body(&self) -> bool

Whether the failure happened while reading or writing the body.

pub fn is_decode(&self) -> bool

Whether the failure was in decoding the response.

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

The HTTP status, when the failure carried one.

pub fn url(&self) -> Option<&str>

The URL the request was for, if reqwest recorded one.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for TransportError

fn source(&self) -> Option<&(dyn Error + 'static)>

The inner error’s cause, not the inner error itself.

Display already delegates to reqwest::Error, so returning it here as well would print the same sentence twice in any formatter that walks the chain — which is most of them. Skipping a link that carries no new text keeps the chain informative.

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.