sark-core 0.8.5

the L7 layer for dope
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

use std::borrow::Cow;
use std::io;

use http::StatusCode;
use thiserror::Error;

use crate::http::Response;

pub type Result<T> = std::result::Result<T, Error>;

#[derive(Error, Debug)]
pub enum Error {
    #[error("Not found")]
    NotFound,

    #[error("Method not allowed")]
    MethodNotAllowed,

    #[error("Bad request: {0}")]
    BadRequest(Cow<'static, str>),

    #[error("Payload too large: {0}")]
    PayloadTooLarge(Cow<'static, str>),

    #[error("Unauthorized: {0}")]
    Unauthorized(Cow<'static, str>),

    #[error("Forbidden: {0}")]
    Forbidden(Cow<'static, str>),

    #[error("Internal server error: {0}")]
    InternalServerError(Cow<'static, str>),

    #[error("Internal error: {0}")]
    Internal(Cow<'static, str>),

    #[error("IO error: {0}")]
    Io(#[from] io::Error),

    #[error("HTTP error: {0}")]
    Http(#[from] http::Error),

    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    #[error("HTTP parse error: {0}")]
    HttpParse(#[from] httparse::Error),
}

#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)]
pub enum ErrorBodyFormat {
    #[default]
    PlainText,
    Json,
}

impl Error {
    pub fn invalid_integer_header() -> Self {
        Self::BadRequest("Invalid integer header".into())
    }

    pub fn status_code(&self) -> StatusCode {
        match self {
            Self::NotFound => StatusCode::NOT_FOUND,
            Self::MethodNotAllowed => StatusCode::METHOD_NOT_ALLOWED,
            Self::BadRequest(_) => StatusCode::BAD_REQUEST,
            Self::PayloadTooLarge(_) => StatusCode::PAYLOAD_TOO_LARGE,
            Self::Unauthorized(_) => StatusCode::UNAUTHORIZED,
            Self::Forbidden(_) => StatusCode::FORBIDDEN,
            Self::InternalServerError(_) => StatusCode::INTERNAL_SERVER_ERROR,
            Self::Internal(_) => StatusCode::INTERNAL_SERVER_ERROR,
            Self::Io(_) => StatusCode::INTERNAL_SERVER_ERROR,
            Self::Http(_) => StatusCode::INTERNAL_SERVER_ERROR,
            Self::Json(_) => StatusCode::BAD_REQUEST,
            Self::HttpParse(_) => StatusCode::BAD_REQUEST,
        }
    }

    pub fn to_response(&self) -> Response {
        self.to_response_with_format(ErrorBodyFormat::PlainText)
    }

    pub fn to_response_with_format(&self, format: ErrorBodyFormat) -> Response {
        let status = self.status_code();
        match format {
            ErrorBodyFormat::PlainText => Response::text_with_status(status, &self.to_string()),
            ErrorBodyFormat::Json => {
                let payload = serde_json::json!({
                    "status": status.as_u16(),
                    "error": self.to_string(),
                });
                match Response::json_with_status(status, &payload) {
                    Ok(r) => r,
                    Err(e) => Response::text_with_status(
                        StatusCode::INTERNAL_SERVER_ERROR,
                        &format!("Internal server error: {}", e),
                    ),
                }
            }
        }
    }
}

impl From<&Error> for Response {
    fn from(err: &Error) -> Self {
        err.to_response()
    }
}

impl From<Error> for Response {
    fn from(err: Error) -> Self {
        err.to_response()
    }
}

#[cfg(test)]
mod tests;