actix_failwrap 1.0.3

A micro-package that enables ergonomic error propagation (using thiserror) inside actix-web route handlers.
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

//! Status Code Literal Helpers
//!
//! Helpers for parsing literal status codes
//! combining integers and identifiers.

use strsim::levenshtein;

/// **`STATUS_CODES`**
///
/// A constant array associating number
/// status codes to their identifiers.
static STATUS_CODES: &[(usize, &str)] = &[
    (400, "BadRequest"),
    (401, "Unauthorized"),
    (402, "PaymentRequired"),
    (403, "Forbidden"),
    (404, "NotFound"),
    (405, "MethodNotAllowed"),
    (406, "NotAcceptable"),
    (407, "ProxyAuthenticationRequired"),
    (408, "RequestTimeout"),
    (409, "Conflict"),
    (410, "Gone"),
    (411, "LengthRequired"),
    (412, "PreconditionFailed"),
    (413, "PayloadTooLarge"),
    (414, "UriTooLong"),
    (415, "UnsupportedMediaType"),
    (416, "RangeNotSatisfiable"),
    (417, "ExpectationFailed"),
    (418, "ImATeapot"),
    (421, "MisdirectedRequest"),
    (422, "UnprocessableEntity"),
    (423, "Locked"),
    (424, "FailedDependency"),
    (425, "TooEarly"),
    (426, "UpgradeRequired"),
    (428, "PreconditionRequired"),
    (429, "TooManyRequests"),
    (431, "RequestHeaderFieldsTooLarge"),
    (451, "UnavailableForLegalReasons"),
    (500, "InternalServerError"),
    (501, "NotImplemented"),
    (502, "BadGateway"),
    (503, "ServiceUnavailable"),
    (504, "GatewayTimeout"),
    (505, "HttpVersionNotSupported"),
    (506, "VariantAlsoNegotiates"),
    (507, "InsufficientStorage"),
    (508, "LoopDetected"),
    (510, "NotExtended"),
    (511, "NetworkAuthenticationRequired"),
];

/// **`allowed_status_pairs()`**
///
/// A getter to the private **`STATUS_CODES`**.
pub fn allowed_status_pairs() -> &'static [(usize, &'static str)] {
    STATUS_CODES
}

/// **`code_to_status()`**
///
/// Converts a numeric code to an identifier and returns
/// Some if it could be converted, otherwise false.
pub fn code_to_status(target_code: usize) -> Option<&'static str> {
    STATUS_CODES
        .iter()
        .find(|(supported_code, _)| &target_code == supported_code)
        .map(|(_, supported_status)| *supported_status)
}

/// **`is_status_supported()`**
///
/// Returns true if the `target_status` is supported
/// by the crate, otherwise false.
pub fn is_status_supported(target_status: &str) -> bool {
    STATUS_CODES
        .iter()
        .any(|(_, supported_status)| &target_status == supported_status)
}

/// **`closest_status()`**
///
/// Applies the edit distance algorithm to a typoed
/// status code identifier and returns the most-likely
/// to be status code.
pub fn closest_status(target_status: &str) -> &str {
    STATUS_CODES
        .iter()
        .min_by_key(|(_, supported_status)| levenshtein(supported_status, target_status))
        .map_or_else(|| unreachable!(), |(_, supported_status)| *supported_status)
}