explicit-error-http 0.3.1

Explicit concrete Error type to manage and monitor errors that generate an HTTP response. It has dedicated feature flag to integrate well with most populars web frameworks.
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use axum::{
    Router,
    body::Body,
    http::{self, Request, StatusCode},
    routing::get,
};
// import only derive to validate that derives work without any required import
use super::{ErrorBody, MyDomainError};
use explicit_error_http::derive::HandlerErrorHelpers;
use http_body_util::BodyExt;
use serde::Serialize;
use tower::util::ServiceExt;

#[derive(HandlerErrorHelpers)]
struct MyHandlerError(explicit_error_http::Error);

impl explicit_error_http::HandlerError for MyHandlerError {
    fn from_error(value: explicit_error_http::Error) -> Self {
        MyHandlerError(value)
    }

    fn public_fault_response(_: &explicit_error_http::Fault) -> impl Serialize {
        ErrorBody {
            foo: "fault".to_string(),
            bar: 500,
        }
    }

    fn error(&self) -> &explicit_error_http::Error {
        &self.0
    }

    fn domain_response(_: &explicit_error_http::DomainError) -> impl Serialize {
        ErrorBody {
            foo: "domain".to_string(),
            bar: 200,
        }
    }
}

fn app() -> Router {
    Router::new()
        .route("/domain", get(domain_error))
        .route("/domain2", get(domain_error2))
        .route("/fault", get(fault_error))
}

#[tokio::test]
async fn handler_derive() {
    let resp = app()
        .oneshot(
            Request::builder()
                .uri("/domain")
                .body(Body::empty())
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::FORBIDDEN);
    let resp = serde_json::from_str::<ErrorBody>(
        std::str::from_utf8(&resp.into_body().collect().await.unwrap().to_bytes()).unwrap(),
    )
    .unwrap();
    assert_eq!(resp.foo, "domain");
    assert_eq!(resp.bar, 200);

    let resp = app()
        .oneshot(
            Request::builder()
                .uri("/domain2")
                .body(Body::empty())
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::BAD_REQUEST);
    let resp = serde_json::from_str::<ErrorBody>(
        std::str::from_utf8(&resp.into_body().collect().await.unwrap().to_bytes()).unwrap(),
    )
    .unwrap();
    assert_eq!(resp.foo, "domain");
    assert_eq!(resp.bar, 200);

    let resp = app()
        .oneshot(
            Request::builder()
                .uri("/fault")
                .body(Body::empty())
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::INTERNAL_SERVER_ERROR);
    let resp = serde_json::from_str::<ErrorBody>(
        std::str::from_utf8(&resp.into_body().collect().await.unwrap().to_bytes()).unwrap(),
    )
    .unwrap();
    assert_eq!(resp.foo, "fault");
    assert_eq!(resp.bar, 500);
}

async fn domain_error() -> Result<StatusCode, MyHandlerError> {
    Err(explicit_error_http::HttpError {
        http_status_code: http::StatusCode::FORBIDDEN,
        public: Box::new(""),
        context: None,
    })?;

    Ok(StatusCode::OK)
}

async fn domain_error2() -> Result<StatusCode, MyHandlerError> {
    Err(explicit_error_http::Error::from(MyDomainError))?;

    Ok(StatusCode::OK)
}

async fn fault_error() -> Result<StatusCode, MyHandlerError> {
    Err(explicit_error_http::Fault::new())?;

    Ok(StatusCode::OK)
}