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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
/// Enum for representing gemini status codes.
#[derive(Debug)]
pub enum Status {
/// 10 As per definition of single-digit code 1 in 3.2.
Input,
/// 11 As per status code 10, but for use with sensitive input such
/// as passwords. Clients should present the prompt as per status
/// code 10, but the user's input should not be echoed to the screen
/// to prevent it being read by "shoulder surfers".
SensitiveInput,
/// 20 As per definition of single-digit code 2 in 3.2.
Success,
/// 30 As per definition of single-digit code 3 in 3.2.
RedirectTemporary,
/// 31 The requested resource should be consistently requested from
/// the new URL provided in future. Tools like search engine indexers
/// or content aggregators should update their configurations to avoid
/// requesting the old URL, and end-user clients may automatically
/// update bookmarks, etc. Note that clients which only pay attention
/// to the initial digit of status codes will treat this as a
/// temporary redirect. They will still end up at the right place,
/// they just won't be able to make use of the knowledge that this
/// redirect is permanent, so they'll pay a small performance penalty
/// by having to follow the redirect each time.
RedirectPermanent,
/// 40 As per definition of single-digit code 4 in 3.2.
TemporaryFailure,
/// 41 The server is unavailable due to overload or maintenance. (cf
/// HTTP 503)
ServerUnavailable,
/// 42 A CGI process, or similar system for generating dynamic
/// content, died unexpectedly or timed out.
CgiError,
/// 43 A proxy request failed because the server was unable to
/// successfully complete a transaction with the remote host. (cf
/// HTTP 502, 504)
ProxyError,
/// 44 Rate limiting is in effect. <META> is an integer number of
/// seconds which the client must wait before another request is
/// made to this server. (cf HTTP 429)
SlowDown,
/// 50 As per definition of single-digit code 5 in 3.2.
PermanentFailure,
/// 51 The requested resource could not be found but may be
/// available in the future. (cf HTTP 404) (struggling to remember
/// this important status code? Easy: you can't find things hidden
/// at Area 51!)
NotFound,
/// 52 The resource requested is no longer available and will not
/// be available again. Search engines and similar tools should
/// remove this resource from their indices. Content aggregators
/// should stop requesting the resource and convey to their human
/// users that the subscribed resource is gone. (cf HTTP 410)
Gone,
/// 53 The request was for a resource at a domain not served by the
/// server and the server does not accept proxy requests.
ProxyRequestRefused,
/// 59 The server was unable to parse the client's request, presumably
/// due to a malformed request. (cf HTTP 400)
BadRequest,
/// 60 As per definition of single-digit code 6 in 3.2.
ClientCertificateRequired,
/// 61 The supplied client certificate is not authorised for accessing
/// the particular requested resource. The problem is not with the
/// certificate itself, which may be authorised for other resources.
CertificateNotAuthorised,
/// 62 The supplied client certificate was not accepted because it is
/// not valid. This indicates a problem with the certificate in and
/// of itself, with no consideration of the particular requested
/// resource. The most likely cause is that the certificate's
/// validity start date is in the future or its expiry date has
/// passed, but this code may also indicate an invalid signature,
/// or a violation of X509 standard requirements. The <META> should
/// provide more information about the exact error.
CertificateNotValid,
/// _ Represents any other unsupported status code
BadStatus,
}
impl std::fmt::Display for Status {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
write!(f, "{} {self:?}", self.value())
}
}
impl Status {
/// Return the status number this enum entry represents.
///
/// ## Notice
///
/// This returns 0 if you give it `Status::BadStatus`, which is a
/// catch-all for invalid statuses.
pub fn value(&self) -> u8 {
match self {
Status::Input => 10,
Status::SensitiveInput => 11,
Status::Success => 20,
Status::RedirectTemporary => 30,
Status::RedirectPermanent => 31,
Status::TemporaryFailure => 40,
Status::ServerUnavailable => 41,
Status::CgiError => 42,
Status::ProxyError => 43,
Status::SlowDown => 44,
Status::PermanentFailure => 50,
Status::NotFound => 51,
Status::Gone => 52,
Status::ProxyRequestRefused => 53,
Status::BadRequest => 59,
Status::ClientCertificateRequired => 60,
Status::CertificateNotAuthorised => 61,
Status::CertificateNotValid => 62,
Status::BadStatus => 0,
}
}
}
impl From<u8> for Status {
fn from(n: u8) -> Self {
match n {
10 => Status::Input,
11 => Status::SensitiveInput,
20 => Status::Success,
30 => Status::RedirectTemporary,
31 => Status::RedirectPermanent,
40 => Status::TemporaryFailure,
41 => Status::ServerUnavailable,
42 => Status::CgiError,
43 => Status::ProxyError,
44 => Status::SlowDown,
50 => Status::PermanentFailure,
51 => Status::NotFound,
52 => Status::Gone,
53 => Status::ProxyRequestRefused,
59 => Status::BadRequest,
60 => Status::ClientCertificateRequired,
61 => Status::CertificateNotAuthorised,
62 => Status::CertificateNotValid,
_ => Status::BadStatus,
}
}
}
impl Into<u8> for Status {
fn into(self) -> u8 {
self.value()
}
}