Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Error),
    Timeout(TimeoutError),
    Protocol(ProtocolError),
    Config(ConfigError),
    Http(Error),
    External(BoxError),
}

Top-level error type.

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.

Io(Error)

Transport-level I/O error (TCP read/write/connect).

Timeout(TimeoutError)

Operation exceeded a configured deadline.

Protocol(ProtocolError)

Wire-protocol failure (parsing, headers, encapsulation, etc.).

Config(ConfigError)

Builder / configuration failure (invalid service options, unknown alias, missing handlers, …).

Http(Error)

Error returned by the http crate builders.

External(BoxError)

Error from outside this crate, preserved via ToIcapResult or Error::external. The original error is available through source().

Implementations

impl Error

pub const fn is_io(&self) -> bool

True if the error originates from an I/O failure on the transport.

pub const fn is_timeout(&self) -> bool

True if the error originates from a deadline (any TimeoutKind).

pub const fn is_protocol(&self) -> bool

True if the error came from the wire protocol layer.

pub const fn is_body_too_large(&self) -> bool

True if the peer sent an embedded body larger than a configured limit.

pub const fn is_config(&self) -> bool

True if the error came from builder / configuration validation.

pub const fn is_early_close(&self) -> bool

True for the “peer closed before headers” case — common on kept-alive connections that the server has idle-closed.

pub const fn is_retryable(&self) -> bool

True if a fresh attempt is likely to succeed.

Conservative: connection-establishment timeouts, idle keep-alive closure, and EarlyClose are considered retryable. Application-level protocol errors are not retryable — the peer will reject the same bytes again.

pub fn parse(message: impl Into<String>) -> Self

Build a protocol parse error.

pub fn http_parse(message: impl Into<String>) -> Self

Build an embedded-HTTP parse error.

pub fn header(message: impl Into<String>) -> Self

Build a generic header error.

pub fn body(message: impl Into<String>) -> Self

Build a body error.

pub const fn body_too_large(size: usize, max: usize) -> Self

Build an oversized-body protocol error.

pub fn serialization(message: impl Into<String>) -> Self

Build a serialization error.

pub fn service(message: impl Into<String>) -> Self

Build a service / configuration error.

pub const fn missing_header(name: &'static str) -> Self

Build a “missing required header” protocol error.

pub fn invalid_istag(value: impl Into<String>) -> Self

Build an “invalid ISTag” protocol error.

pub fn invalid_status_code(value: impl Into<String>) -> Self

Build an “invalid status code” protocol error.

pub fn invalid_method(value: impl Into<String>) -> Self

Build an “invalid method” protocol error.

pub fn invalid_uri(value: impl Into<String>) -> Self

Build an “invalid URI” protocol error.

pub fn invalid_version(value: impl Into<String>) -> Self

Build an “invalid protocol version” protocol error.

pub fn external<E>(err: E) -> Self

where E: StdError + Send + Sync + 'static,

Build an External error from any std::error::Error.

pub fn unexpected(message: impl Into<String>) -> Self

Build an External error from an ad-hoc message string.

pub const fn timeout(kind: TimeoutKind, duration: Duration) -> Self

Build a Timeout from a kind + duration.

pub const fn client_total_timeout(d: Duration) -> Self

pub const fn client_connect_timeout(d: Duration) -> Self

pub const fn client_write_timeout(d: Duration) -> Self

pub const fn client_continue_timeout(d: Duration) -> Self

pub const fn server_header_read_timeout(d: Duration) -> Self

pub const fn server_body_read_timeout(d: Duration) -> Self

pub const fn server_write_timeout(d: Duration) -> Self

pub const fn server_idle_timeout(d: Duration) -> Self

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<ConfigError> for Error

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(e: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderName> for Error

fn from(e: InvalidHeaderName) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for Error

fn from(e: InvalidHeaderValue) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for Error

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.

impl From<TimeoutError> for Error

fn from(source: TimeoutError) -> Self

Converts to this type from the input type.

impl From<ToStrError> for Error

fn from(e: ToStrError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(e: Utf8Error) -> Self

Converts to this type from the input type.