anyhow-http 0.1.0

Customizable HTTP errors built on anyhow
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# anyhow-http

<a href="https://github.com/heat1q/anyhow-http/actions/workflows/rust.yml">
<img src="https://github.com/heat1q/anyhow-http/actions/workflows/rust.yml/badge.svg" />
</a>
<a href="https://crates.io/crates/anyhow-http">
<img src="https://img.shields.io/crates/v/anyhow-http.svg" />
</a>
<a href="https://docs.rs/anyhow-http">
<img src="https://docs.rs/anyhow-http/badge.svg" />
</a>
<br/>
<br/>

`anyhow-http` offers customizable HTTP errors built on [`anyhow`](https://docs.rs/prometheus/latest/prometheus/) errors. This crates acts as a superset of [`anyhow`](https://docs.rs/prometheus/latest/prometheus/), extending the functionality to define custom HTTP error responses.

## Example 
```rust
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(())
}
```

## License
Licensed under [MIT](https://github.com/heat1q/anyhow-http/blob/master/LICENSE).