Enum ClientError 

#[non_exhaustive]
pub enum ClientError {
    Http {
        status: u16,
        message: String,
        body: String,
        payload: Option<Value>,
    },
    Transport(Error),
    Decode(String),
    UnexpectedContentType(String),
    Arrow(ArrowError),
    InvalidBaseUrl(String),
}

Everything that can go wrong talking to a DataPress server.

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.

Http

The server returned a non-2xx status.

payload is populated when the body parsed as JSON (DataPress errors are {"error": "..."}), so callers can match on the structured message without re-parsing body.

Fields

status: u16

HTTP status code (e.g. 404, 400, 503).

message: String

Best-effort human-readable message (the error field when the body was JSON, otherwise a truncated copy of the raw body).

body: String

Raw response body.

payload: Option<Value>

Parsed JSON body, when the response was application/json.

Transport(Error)

A transport-level failure (DNS, connect, timeout, TLS, …).

Decode(String)

The response body could not be decoded as the expected type.

UnexpectedContentType(String)

The server answered with JSON where Arrow IPC was requested, or vice-versa.

Arrow(ArrowError)

An Arrow IPC stream could not be decoded.

InvalidBaseUrl(String)

The base URL was not a valid URL.

Trait Implementations

impl Debug for ClientError

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

Formats the value using the given formatter.

impl Display for ClientError

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

Formats the value using the given formatter.

impl Error for ClientError

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<ArrowError> for ClientError

fn from(source: ArrowError) -> Self

Converts to this type from the input type.

impl From<Error> for ClientError

fn from(source: Error) -> Self

Converts to this type from the input type.