💾 Archived View for source.community › ckaznocha › gemini › blob › main › status.go captured on 2022-01-08 at 13:43:36. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-12-17)
-=-=-=-=-=-=-
.
,-. ,-. . . ,-. ,-. ,-. ,-. ,-. ,-,-. ,-,-. . . ,-. . |- . .
`-. | | | | | | |-' | | | | | | | | | | | | | | | | |
`-' `-' `-^ ' `-' `-' :: `-' `-' ' ' ' ' ' ' `-^ ' ' ' `' `-|
/|
`-'
git clone https://source.community/ckaznocha/gemini.git
View raw contents of /status.go (main)
────╮
1│ //go:generate stringer -linecomment -output status_string.gen.go -type StatusCodeCategory,StatusCode
2│
3│ package gemini
4│
5│ const (
6│ maxCategory = 9
7│ maxCode = 99
8│ codeDivisor = 10
9│ )
10│
11│ // StatusCodeCategory identifies a class of Gemini status codes.
12│ type StatusCodeCategory uint8
13│
14│ // ToCode converts a Categoy to the base code for that category.
15│ func (c StatusCodeCategory) ToCode() StatusCode {
16│ if c > maxCategory {
17│ return 0
18│ }
19│
20│ return StatusCode(c * codeDivisor)
21│ }
22│
23│ // The status code categories as defined in `Project Gemini - Speculative
24│ // specification - Section 3.2`.
25│ const (
26│ StatusCategoryInput StatusCodeCategory = 1 // INPUT
27│ StatusCategorySuccess StatusCodeCategory = 2 // SUCCESS
28│ StatusCategoryRedirect StatusCodeCategory = 3 // REDIRECT
29│ StatusCategoryTemporaryFailure StatusCodeCategory = 4 // TEMPORARY FAILURE
30│ StatusCategoryPermanentFailure StatusCodeCategory = 5 // PERMANENT FAILURE
31│ StatusCategoryClientCertificateRequired StatusCodeCategory = 6 // CLIENT CERTIFICATE REQUIRED
32│
33│ StatusCategoryUndefined StatusCodeCategory = 0 // UNDEFINED
34│ StatusCategoryUndefinedX StatusCodeCategory = 7 // UNDEFINED
35│ StatusCategoryUndefinedXX StatusCodeCategory = 8 // UNDEFINED
36│ StatusCategoryUndefinedXXX StatusCodeCategory = 9 // UNDEFINED
37│ )
38│
39│ // StatusCode represents a Gemini status code. Gemini status codes are two digit
40│ // values. See `Project Gemini - Speculative specification - Section 3.2`.
41│ type StatusCode uint8
42│
43│ //nolint:gochecknoglobals // un exported lookup table.
44│ var asciiNumbers = [10]byte{'0', '1', '2', '3', '4', '5', '6', '7', '8', '9'}
45│
46│ // MarshalText implements the encoding.TextMarshaler interface. It returns the
47│ // the code as an ASCII byte slice. It returns "00" if the code is invalid.
48│ func (c StatusCode) MarshalText() ([]byte, error) {
49│ if c > maxCode {
50│ return []byte{'0', '0'}, nil
51│ }
52│
53│ return []byte{asciiNumbers[c/codeDivisor], asciiNumbers[c%codeDivisor]}, nil
54│ }
55│
56│ // ToCategory returns which category the status code belongs to.
57│ func (c StatusCode) ToCategory() StatusCodeCategory {
58│ if c > maxCode {
59│ return StatusCategoryUndefined
60│ }
61│
62│ return StatusCodeCategory(c / codeDivisor)
63│ }
64│
65│ // Description returns the description of the code as described in `Project
66│ // Gemini - Speculative specification`. Some but not all of the descriptions may
67│ // be appropriate to return to a client as a failure description.
68│ func (c StatusCode) Description() string {
69│ return statusCodeToText[c]
70│ }
71│
72│ // The status codes as defined in `Project Gemini - Speculative
73│ // specification - Appendix 1. Full two digit status codes`.
74│ const (
75│ // 1x - INPUT
76│ StatusInput StatusCode = 10 // INPUT
77│ StatusSensitiveInput StatusCode = 11 // SENSITIVE INPUT
78│
79│ // 2x - SUCCESS
80│ StatusSuccess StatusCode = 20 // SUCCESS
81│
82│ // 3x - REDIRECT
83│ StatusTemporaryRedirect StatusCode = 30 // REDIRECT - TEMPORARY
84│ StatusPermanentRedirect StatusCode = 31 // REDIRECT - PERMANENT
85│
86│ // 4x - TEMPORARY FAILURE
87│ StatusTemporaryFailure StatusCode = 40 // TEMPORARY FAILURE
88│ StatusServerFailure StatusCode = 41 // SERVER UNAVAILABLE
89│ StatusCGIError StatusCode = 42 // CGI ERROR
90│ StatusProxyError StatusCode = 43 // PROXY ERROR
91│ StatusSlowDown StatusCode = 44 // SLOW DOWN
92│
93│ // 5x - PERMANENT FAILURE
94│ StatusPermanentFailure StatusCode = 50 // PERMANENT FAILURE
95│ StatusNotFound StatusCode = 51 // NOT FOUND
96│ StatusGone StatusCode = 52 // GONE
97│ StatusProxyRequestRefused StatusCode = 53 // PROXY REQUEST REFUSED
98│ StatusBadRequest StatusCode = 59 // BAD REQUEST
99│
100│ // 6x - CLIENT CERTIFICATE REQUIRED
101│ StatusClientCertificateRequired StatusCode = 60 // CLIENT CERTIFICATE REQUIRED
102│ StatusCertificateNotAuthorised StatusCode = 61 // CERTIFICATE NOT AUTHORIZED
103│ StatusCertificateNotValid StatusCode = 62 // CERTIFICATE NOT VALID
104│ )
105│
106│ //nolint:lll,gochecknoglobals // un exported lookup table of very long strings.
107│ var statusCodeToText = map[StatusCode]string{
108│ // 1x - INPUT
109│ StatusInput: `The requested resource accepts a line of textual user input. The <META> line is a prompt which should be displayed to the user. The same resource should then be requested again with the user's input included as a query component. Queries are included in requests as per the usual generic URL definition in RFC3986, i.e. separated from the path by a ?. Reserved characters used in the user's input must be "percent-encoded" as per RFC3986, and space characters should also be percent-encoded.`,
110│ StatusSensitiveInput: `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".`,
111│
112│ // 2x - SUCCESS
113│ StatusSuccess: `The request was handled successfully and a response body will follow the response header. The <META> line is a MIME media type which applies to the response body.`,
114│
115│ // 3x - REDIRECT
116│ StatusTemporaryRedirect: `The server is redirecting the client to a new location for the requested resource. There is no response body. <META> is a new URL for the requested resource. The URL may be absolute or relative. The redirect should be considered temporary, i.e. clients should continue to request the resource at the original address and should not performance convenience actions like automatically updating bookmarks. There is no response body.`,
117│ StatusPermanentRedirect: `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.`,
118│
119│ // 4x - TEMPORARY FAILURE
120│ StatusTemporaryFailure: `The request has failed. There is no response body. The nature of the failure is temporary, i.e. an identical request MAY succeed in the future.`,
121│ StatusServerFailure: `The server is unavailable due to overload or maintenance.`,
122│ StatusCGIError: `A CGI process, or similar system for generating dynamic content, died unexpectedly or timed out.`,
123│ StatusProxyError: `A proxy request failed because the server was unable to successfully complete a transaction with the remote host.)`,
124│ StatusSlowDown: `Rate limiting is in effect.`,
125│
126│ // 5x - PERMANENT FAILURE
127│ StatusPermanentFailure: `The request has failed. There is no response body. The nature of the failure is permanent, i.e. identical future requests will reliably fail for the same reason.`,
128│ StatusNotFound: `The requested resource could not be found but may be available in the future.`,
129│ StatusGone: `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.`,
130│ StatusProxyRequestRefused: `The request was for a resource at a domain not served by the server and the server does not accept proxy requests.`,
131│ StatusBadRequest: `The server was unable to parse the client's request, presumably due to a malformed request.`,
132│
133│ // 6x - CLIENT CERTIFICATE REQUIRED
134│ StatusClientCertificateRequired: `The requested resource requires a client certificate to access. If the request was made without a certificate, it should be repeated with one. If the request was made with a certificate, the server did not accept it and the request should be repeated with a different certificate.`,
135│ StatusCertificateNotAuthorised: `The supplied client certificate is not authorized for accessing the particular requested resource. The problem is not with the certificate itself, which may be authorised for other resources.`,
136│ StatusCertificateNotValid: `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 a X509 standard requirements.`,
137│ }
────╯
· · ·
© 2022 source.community