Enum HttpCacheError 

pub enum HttpCacheError {
    Client(BoxError),
    Cache(String),
    BadRequest(BadRequest),
    Http(BoxError),
    Body(BoxError),
    Streaming(StreamingError),
    Other(BoxError),
}

Unified error type for HTTP cache operations that works across all client libraries.

This enum consolidates error handling patterns from all http-cache client crates (reqwest, surf, tower, ureq) while providing a clean, extensible interface.

Examples

use http_cache::{HttpCacheError, BadRequest};

// Cache operation errors
let cache_err = HttpCacheError::cache("Failed to read cache entry");

// Request parsing errors
let request_err = HttpCacheError::from(BadRequest);

// HTTP processing errors
let http_err = HttpCacheError::http("Invalid header format");

// Body processing errors  
let body_err = HttpCacheError::body("Failed to collect request body");

Variants

Client(BoxError)

HTTP client error (reqwest, surf, etc.)

Cache(String)

HTTP cache operation failed

BadRequest(BadRequest)

Request parsing failed (e.g., non-cloneable request)

Http(BoxError)

HTTP processing error (header parsing, version handling, etc.)

Body(BoxError)

Body processing error (collection, streaming, etc.)

Streaming(StreamingError)

Streaming operation error (with detailed error kind)

Other(BoxError)

Other generic error

Implementations

impl HttpCacheError

pub fn cache<S: Into<String>>(message: S) -> Self

Create a cache operation error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::cache("Cache entry not found");

pub fn http<E: Into<BoxError>>(error: E) -> Self

Create an HTTP processing error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::http("Invalid header format");

pub fn body<E: Into<BoxError>>(error: E) -> Self

Create a body processing error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::body("Failed to collect request body");

pub fn client<E: Into<BoxError>>(error: E) -> Self

Create a client error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::client("Network timeout");

pub fn other<E: Into<BoxError>>(error: E) -> Self

Create a generic error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::other("Unexpected error occurred");

pub fn is_cache_error(&self) -> bool

Returns true if this error is related to cache operations

pub fn is_client_error(&self) -> bool

Returns true if this error is related to client operations

pub fn is_streaming_error(&self) -> bool

Returns true if this error is related to streaming operations

pub fn is_bad_request(&self) -> bool

Returns true if this error is a bad request

Trait Implementations

impl Debug for HttpCacheError

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

Formats the value using the given formatter.

impl Display for HttpCacheError

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

Formats the value using the given formatter.

impl Error for HttpCacheError

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<BadHeader> for HttpCacheError

fn from(error: BadHeader) -> Self

Converts to this type from the input type.

impl From<BadRequest> for HttpCacheError

fn from(error: BadRequest) -> Self

Converts to this type from the input type.

impl From<BadVersion> for HttpCacheError

fn from(error: BadVersion) -> Self

Converts to this type from the input type.

impl From<Box<dyn Error + Sync + Send>> for HttpCacheError

fn from(error: BoxError) -> Self

Converts to this type from the input type.

impl From<ClientStreamingError> for HttpCacheError

fn from(error: ClientStreamingError) -> Self

Converts to this type from the input type.

impl From<Error> for HttpCacheError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpCacheError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<HttpCacheError> for StreamingError

fn from(error: HttpCacheError) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderName> for HttpCacheError

fn from(error: InvalidHeaderName) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for HttpCacheError

fn from(error: InvalidHeaderValue) -> Self

Converts to this type from the input type.

impl From<InvalidMethod> for HttpCacheError

fn from(error: InvalidMethod) -> Self

Converts to this type from the input type.

impl From<InvalidStatusCode> for HttpCacheError

fn from(error: InvalidStatusCode) -> Self

Converts to this type from the input type.

impl From<InvalidUri> for HttpCacheError

fn from(error: InvalidUri) -> Self

Converts to this type from the input type.

impl From<ParseError> for HttpCacheError

fn from(error: ParseError) -> Self

Converts to this type from the input type.

impl From<StreamingError> for HttpCacheError

fn from(error: StreamingError) -> Self

Converts to this type from the input type.