Enum TransportError 

#[non_exhaustive]
pub enum TransportError {
    InvalidConfig(&'static str),
    BuildClient(Error),
    Transport(Error),
    HttpStatus {
        status: StatusCode,
        body: String,
    },
    Deserialize {
        source: Error,
        body: String,
    },
    Utf8(FromUtf8Error),
    BodyTooLarge {
        limit: usize,
    },
    InvalidResponse(String),
}

Errors produced by the shared HTTP/SSE transport layer.

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.

InvalidConfig(&'static str)

BuildClient(Error)

Transport(Error)

HttpStatus

A non-success HTTP status, with the full response body captured as diagnostic text.

body is read under the shared size cap (MAX_BODY_BYTES). Bodies that fit are captured in full; an oversized error body instead surfaces as BodyTooLarge and this variant is not produced. So when this variant is present, body is complete — never a truncated prefix.

Fields

status: StatusCode

body: String

Deserialize

A streamed response chunk could not be deserialized.

Produced only by the SSE event parser, one event at a time. When a TransportError is lifted into a ProviderError via From, this surfaces as ProviderError::Transport(TransportError::Deserialize) — not as ProviderError::Deserialize, which is reserved for full-body failures produced by parse_json. Consumers matching for deserialization failures across both paths must account for both variants.

Fields

source: Error

body: String

Utf8(FromUtf8Error)

BodyTooLarge

A non-streaming response body exceeded the shared size cap and was not fully buffered.

Produced by the capped body reader (read_body_text). Distinct from InvalidResponse, which reports content problems (empty body, malformed structure) rather than a size limit. The reader stops before the offending chunk is appended, so no body text is carried here. When the overflow occurs while reading an error body, the HTTP status is not carried here either — it is visible only to callers that read status off the raw response before consuming the body (the prepare/send path).

Fields

limit: usize

InvalidResponse(String)

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.

impl From<TransportError> for ProviderError

fn from(source: TransportError) -> Self

Converts to this type from the input type.