Crate anyhow_http

anyhow-http offers customizable HTTP errors built on anyhow errors.

This crates acts as a superset of anyhow, extending the functionality to define custom HTTP error responses.

Example with axum

use axum::{
   routing::get,
   response::IntoResponse,
   Router,
};
use anyhow_http::{http_error_ret, response::Result};

#[tokio::main]
async fn main() {
    let app = Router::new()
        .route("/", get(handler));

    let listener = tokio::net::TcpListener::bind("127.0.0.1:3000")
        .await
        .unwrap();
    axum::serve(listener, app).await.unwrap();
}

fn fallible_operation() -> Result<()> {
    http_error_ret!(INTERNAL_SERVER_ERROR, "this is an error")
}

async fn handler() -> Result<impl IntoResponse> {
    fallible_operation()?;
    Ok(())
}

Re-exports

• pub use http;

Modules

• response
  Creating responses from HttpError.

Macros

• http_error
  Construct an ad-hoc HttpError from a status code, optional source error and formatted reason.
• http_error_ret
  Shorthand macro to return early with a HttpError.

Structs

• HttpError
  HttpError is an error that can be represented as a HTTP response. HttpError is generic over its response format, allowing consumers to implement their custom error response. See IntoHttpErrorResponse.

Traits

• OptionExt
  Extension trait to transform an Option to a HttpError.
• ResultExt
  Extension trait to map the error variant of a Result to a HttpError.