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 addr = std::net::SocketAddr::from(([127, 0, 0, 1], 3000));
    axum::Server::bind(&addr)
        .serve(app.into_make_service())
        .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_map_fn
  Shorthand macro to map to a HttpError from any error within .map_err().
• 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.