diff --git a/src/status.rs b/src/status.rs
index 3e6db8bd93..80889d6afd 100644
--- a/src/status.rs
+++ b/src/status.rs
@@ -1,1048 +1,235 @@
-//! Status Codes
+//! HTTP status codes
use std::fmt;
use std::num::{FromPrimitive, ToPrimitive};
-use std::mem::transmute;
-
-use std::cmp::Ordering::{self, Less, Equal, Greater};
+use std::cmp::Ordering;
// shamelessly lifted from Teepee. I tried a few schemes, this really
-// does seem like the best.
+// does seem like the best. Improved scheme to support arbitary status codes.
-/// An HTTP status code (`Status-Code` in RFC 2616).
-///
-/// This enum is absolutely exhaustive, covering all 500 possible values (100–599).
-///
-/// For HTTP/2.0, statuses belonging to the 1xx Informational class are invalid.
+/// An HTTP status code (`status-code` in RFC 7230 et al.).
///
-/// As this is a C‐style enum with each variant having a corresponding value, you may use the likes
-/// of `Continue as u16` to retreive the value `100u16`. Normally, though, you should not need to do
-/// any such thing; just use the status code as a `StatusCode`.
+/// This enum contains all common status codes and an Unregistered
+/// extension variant. It allows status codes in the range [0, 65535], as any
+/// `u16` integer may be used as a status code for XHR requests. It is
+/// recommended to only use values between [100, 599], since only these are
+/// defined as valid status codes with a status class by HTTP.
///
-/// If you encounter a status code that you do not know how to deal with, you should treat it as the
-/// `x00` status code—e.g. for code 123, treat it as 100 (Continue). This can be achieved with
+/// If you encounter a status code that you do not know how to deal with, you
+/// should treat it as the `x00` status code—e.g. for code 123, treat it as
+/// 100 (Continue). This can be achieved with
/// `self.class().default_code()`:
///
/// ```rust
-/// # use hyper::status::StatusCode::{Code123, Continue};
-/// assert_eq!(Code123.class().default_code(), Continue);
+/// # use std::num::FromPrimitive;
+/// # use hyper::status::StatusCode;
+/// let statusopt: Option<StatusCode> = FromPrimitive::from_u16(137u16);
+/// assert_eq!(statusopt.unwrap().class().default_code(), StatusCode::Continue);
/// ```
-#[derive(Debug)]
+///
+/// IANA maintain the [Hypertext Transfer Protocol (HTTP) Status Code
+/// Registry](http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml) which is
+/// the source for this enum (with one exception, 418 I'm a teapot, which is
+/// inexplicably not in the register).
pub enum StatusCode {
/// 100 Continue
- Continue = 100,
+ /// [[RFC7231, Section 6.2.1](https://tools.ietf.org/html/rfc7231#section-6.2.1)]
+ Continue,
/// 101 Switching Protocols
- SwitchingProtocols = 101,
+ /// [[RFC7231, Section 6.2.2](https://tools.ietf.org/html/rfc7231#section-6.2.2)]
+ SwitchingProtocols,
/// 102 Processing
- Processing = 102,
- /// 103 (unregistered)
- Code103 = 103,
- /// 104 (unregistered)
- Code104 = 104,
- /// 105 (unregistered)
- Code105 = 105,
- /// 106 (unregistered)
- Code106 = 106,
- /// 107 (unregistered)
- Code107 = 107,
- /// 108 (unregistered)
- Code108 = 108,
- /// 109 (unregistered)
- Code109 = 109,
- /// 110 (unregistered)
- Code110 = 110,
- /// 111 (unregistered)
- Code111 = 111,
- /// 112 (unregistered)
- Code112 = 112,
- /// 113 (unregistered)
- Code113 = 113,
- /// 114 (unregistered)
- Code114 = 114,
- /// 115 (unregistered)
- Code115 = 115,
- /// 116 (unregistered)
- Code116 = 116,
- /// 117 (unregistered)
- Code117 = 117,
- /// 118 (unregistered)
- Code118 = 118,
- /// 119 (unregistered)
- Code119 = 119,
- /// 120 (unregistered)
- Code120 = 120,
- /// 121 (unregistered)
- Code121 = 121,
- /// 122 (unregistered)
- Code122 = 122,
- /// 123 (unregistered)
- Code123 = 123,
- /// 124 (unregistered)
- Code124 = 124,
- /// 125 (unregistered)
- Code125 = 125,
- /// 126 (unregistered)
- Code126 = 126,
- /// 127 (unregistered)
- Code127 = 127,
- /// 128 (unregistered)
- Code128 = 128,
- /// 129 (unregistered)
- Code129 = 129,
- /// 130 (unregistered)
- Code130 = 130,
- /// 131 (unregistered)
- Code131 = 131,
- /// 132 (unregistered)
- Code132 = 132,
- /// 133 (unregistered)
- Code133 = 133,
- /// 134 (unregistered)
- Code134 = 134,
- /// 135 (unregistered)
- Code135 = 135,
- /// 136 (unregistered)
- Code136 = 136,
- /// 137 (unregistered)
- Code137 = 137,
- /// 138 (unregistered)
- Code138 = 138,
- /// 139 (unregistered)
- Code139 = 139,
- /// 140 (unregistered)
- Code140 = 140,
- /// 141 (unregistered)
- Code141 = 141,
- /// 142 (unregistered)
- Code142 = 142,
- /// 143 (unregistered)
- Code143 = 143,
- /// 144 (unregistered)
- Code144 = 144,
- /// 145 (unregistered)
- Code145 = 145,
- /// 146 (unregistered)
- Code146 = 146,
- /// 147 (unregistered)
- Code147 = 147,
- /// 148 (unregistered)
- Code148 = 148,
- /// 149 (unregistered)
- Code149 = 149,
- /// 150 (unregistered)
- Code150 = 150,
- /// 151 (unregistered)
- Code151 = 151,
- /// 152 (unregistered)
- Code152 = 152,
- /// 153 (unregistered)
- Code153 = 153,
- /// 154 (unregistered)
- Code154 = 154,
- /// 155 (unregistered)
- Code155 = 155,
- /// 156 (unregistered)
- Code156 = 156,
- /// 157 (unregistered)
- Code157 = 157,
- /// 158 (unregistered)
- Code158 = 158,
- /// 159 (unregistered)
- Code159 = 159,
- /// 160 (unregistered)
- Code160 = 160,
- /// 161 (unregistered)
- Code161 = 161,
- /// 162 (unregistered)
- Code162 = 162,
- /// 163 (unregistered)
- Code163 = 163,
- /// 164 (unregistered)
- Code164 = 164,
- /// 165 (unregistered)
- Code165 = 165,
- /// 166 (unregistered)
- Code166 = 166,
- /// 167 (unregistered)
- Code167 = 167,
- /// 168 (unregistered)
- Code168 = 168,
- /// 169 (unregistered)
- Code169 = 169,
- /// 170 (unregistered)
- Code170 = 170,
- /// 171 (unregistered)
- Code171 = 171,
- /// 172 (unregistered)
- Code172 = 172,
- /// 173 (unregistered)
- Code173 = 173,
- /// 174 (unregistered)
- Code174 = 174,
- /// 175 (unregistered)
- Code175 = 175,
- /// 176 (unregistered)
- Code176 = 176,
- /// 177 (unregistered)
- Code177 = 177,
- /// 178 (unregistered)
- Code178 = 178,
- /// 179 (unregistered)
- Code179 = 179,
- /// 180 (unregistered)
- Code180 = 180,
- /// 181 (unregistered)
- Code181 = 181,
- /// 182 (unregistered)
- Code182 = 182,
- /// 183 (unregistered)
- Code183 = 183,
- /// 184 (unregistered)
- Code184 = 184,
- /// 185 (unregistered)
- Code185 = 185,
- /// 186 (unregistered)
- Code186 = 186,
- /// 187 (unregistered)
- Code187 = 187,
- /// 188 (unregistered)
- Code188 = 188,
- /// 189 (unregistered)
- Code189 = 189,
- /// 190 (unregistered)
- Code190 = 190,
- /// 191 (unregistered)
- Code191 = 191,
- /// 192 (unregistered)
- Code192 = 192,
- /// 193 (unregistered)
- Code193 = 193,
- /// 194 (unregistered)
- Code194 = 194,
- /// 195 (unregistered)
- Code195 = 195,
- /// 196 (unregistered)
- Code196 = 196,
- /// 197 (unregistered)
- Code197 = 197,
- /// 198 (unregistered)
- Code198 = 198,
- /// 199 (unregistered)
- Code199 = 199,
+ /// [[RFC2518](https://tools.ietf.org/html/rfc2518)]
+ Processing,
/// 200 OK
- Ok = 200,
+ /// [[RFC7231, Section 6.3.1](https://tools.ietf.org/html/rfc7231#section-6.3.1)]
+ Ok,
/// 201 Created
- Created = 201,
+ /// [[RFC7231, Section 6.3.2](https://tools.ietf.org/html/rfc7231#section-6.3.2)]
+ Created,
/// 202 Accepted
- Accepted = 202,
+ /// [[RFC7231, Section 6.3.3](https://tools.ietf.org/html/rfc7231#section-6.3.3)]
+ Accepted,
/// 203 Non-Authoritative Information
- NonAuthoritativeInformation = 203,
+ /// [[RFC7231, Section 6.3.4](https://tools.ietf.org/html/rfc7231#section-6.3.4)]
+ NonAuthoritativeInformation,
/// 204 No Content
- NoContent = 204,
+ /// [[RFC7231, Section 6.3.5](https://tools.ietf.org/html/rfc7231#section-6.3.5)]
+ NoContent,
/// 205 Reset Content
- ResetContent = 205,
+ /// [[RFC7231, Section 6.3.6](https://tools.ietf.org/html/rfc7231#section-6.3.6)]
+ ResetContent,
/// 206 Partial Content
- PartialContent = 206,
+ /// [[RFC7233, Section 4.1](https://tools.ietf.org/html/rfc7233#section-4.1)]
+ PartialContent,
/// 207 Multi-Status
- MultiStatus = 207,
+ /// [[RFC4918](https://tools.ietf.org/html/rfc4918)]
+ MultiStatus,
/// 208 Already Reported
- AlreadyReported = 208,
- /// 209 (unregistered)
- Code209 = 209,
- /// 210 (unregistered)
- Code210 = 210,
- /// 211 (unregistered)
- Code211 = 211,
- /// 212 (unregistered)
- Code212 = 212,
- /// 213 (unregistered)
- Code213 = 213,
- /// 214 (unregistered)
- Code214 = 214,
- /// 215 (unregistered)
- Code215 = 215,
- /// 216 (unregistered)
- Code216 = 216,
- /// 217 (unregistered)
- Code217 = 217,
- /// 218 (unregistered)
- Code218 = 218,
- /// 219 (unregistered)
- Code219 = 219,
- /// 220 (unregistered)
- Code220 = 220,
- /// 221 (unregistered)
- Code221 = 221,
- /// 222 (unregistered)
- Code222 = 222,
- /// 223 (unregistered)
- Code223 = 223,
- /// 224 (unregistered)
- Code224 = 224,
- /// 225 (unregistered)
- Code225 = 225,
+ /// [[RFC5842](https://tools.ietf.org/html/rfc5842)]
+ AlreadyReported,
+
/// 226 IM Used
- ImUsed = 226,
- /// 227 (unregistered)
- Code227 = 227,
- /// 228 (unregistered)
- Code228 = 228,
- /// 229 (unregistered)
- Code229 = 229,
- /// 230 (unregistered)
- Code230 = 230,
- /// 231 (unregistered)
- Code231 = 231,
- /// 232 (unregistered)
- Code232 = 232,
- /// 233 (unregistered)
- Code233 = 233,
- /// 234 (unregistered)
- Code234 = 234,
- /// 235 (unregistered)
- Code235 = 235,
- /// 236 (unregistered)
- Code236 = 236,
- /// 237 (unregistered)
- Code237 = 237,
- /// 238 (unregistered)
- Code238 = 238,
- /// 239 (unregistered)
- Code239 = 239,
- /// 240 (unregistered)
- Code240 = 240,
- /// 241 (unregistered)
- Code241 = 241,
- /// 242 (unregistered)
- Code242 = 242,
- /// 243 (unregistered)
- Code243 = 243,
- /// 244 (unregistered)
- Code244 = 244,
- /// 245 (unregistered)
- Code245 = 245,
- /// 246 (unregistered)
- Code246 = 246,
- /// 247 (unregistered)
- Code247 = 247,
- /// 248 (unregistered)
- Code248 = 248,
- /// 249 (unregistered)
- Code249 = 249,
- /// 250 (unregistered)
- Code250 = 250,
- /// 251 (unregistered)
- Code251 = 251,
- /// 252 (unregistered)
- Code252 = 252,
- /// 253 (unregistered)
- Code253 = 253,
- /// 254 (unregistered)
- Code254 = 254,
- /// 255 (unregistered)
- Code255 = 255,
- /// 256 (unregistered)
- Code256 = 256,
- /// 257 (unregistered)
- Code257 = 257,
- /// 258 (unregistered)
- Code258 = 258,
- /// 259 (unregistered)
- Code259 = 259,
- /// 260 (unregistered)
- Code260 = 260,
- /// 261 (unregistered)
- Code261 = 261,
- /// 262 (unregistered)
- Code262 = 262,
- /// 263 (unregistered)
- Code263 = 263,
- /// 264 (unregistered)
- Code264 = 264,
- /// 265 (unregistered)
- Code265 = 265,
- /// 266 (unregistered)
- Code266 = 266,
- /// 267 (unregistered)
- Code267 = 267,
- /// 268 (unregistered)
- Code268 = 268,
- /// 269 (unregistered)
- Code269 = 269,
- /// 270 (unregistered)
- Code270 = 270,
- /// 271 (unregistered)
- Code271 = 271,
- /// 272 (unregistered)
- Code272 = 272,
- /// 273 (unregistered)
- Code273 = 273,
- /// 274 (unregistered)
- Code274 = 274,
- /// 275 (unregistered)
- Code275 = 275,
- /// 276 (unregistered)
- Code276 = 276,
- /// 277 (unregistered)
- Code277 = 277,
- /// 278 (unregistered)
- Code278 = 278,
- /// 279 (unregistered)
- Code279 = 279,
- /// 280 (unregistered)
- Code280 = 280,
- /// 281 (unregistered)
- Code281 = 281,
- /// 282 (unregistered)
- Code282 = 282,
- /// 283 (unregistered)
- Code283 = 283,
- /// 284 (unregistered)
- Code284 = 284,
- /// 285 (unregistered)
- Code285 = 285,
- /// 286 (unregistered)
- Code286 = 286,
- /// 287 (unregistered)
- Code287 = 287,
- /// 288 (unregistered)
- Code288 = 288,
- /// 289 (unregistered)
- Code289 = 289,
- /// 290 (unregistered)
- Code290 = 290,
- /// 291 (unregistered)
- Code291 = 291,
- /// 292 (unregistered)
- Code292 = 292,
- /// 293 (unregistered)
- Code293 = 293,
- /// 294 (unregistered)
- Code294 = 294,
- /// 295 (unregistered)
- Code295 = 295,
- /// 296 (unregistered)
- Code296 = 296,
- /// 297 (unregistered)
- Code297 = 297,
- /// 298 (unregistered)
- Code298 = 298,
- /// 299 (unregistered)
- Code299 = 299,
+ /// [[RFC3229](https://tools.ietf.org/html/rfc3229)]
+ ImUsed,
/// 300 Multiple Choices
- MultipleChoices = 300,
+ /// [[RFC7231, Section 6.4.1](https://tools.ietf.org/html/rfc7231#section-6.4.1)]
+ MultipleChoices,
/// 301 Moved Permanently
- MovedPermanently = 301,
+ /// [[RFC7231, Section 6.4.2](https://tools.ietf.org/html/rfc7231#section-6.4.2)]
+ MovedPermanently,
/// 302 Found
- Found = 302,
+ /// [[RFC7231, Section 6.4.3](https://tools.ietf.org/html/rfc7231#section-6.4.3)]
+ Found,
/// 303 See Other
- SeeOther = 303,
+ /// [[RFC7231, Section 6.4.4](https://tools.ietf.org/html/rfc7231#section-6.4.4)]
+ SeeOther,
/// 304 Not Modified
- NotModified = 304,
+ /// [[RFC7232, Section 4.1](https://tools.ietf.org/html/rfc7232#section-4.1)]
+ NotModified,
/// 305 Use Proxy
- UseProxy = 305,
- /// 306 Switch Proxy
- SwitchProxy = 306,
+ /// [[RFC7231, Section 6.4.5](https://tools.ietf.org/html/rfc7231#section-6.4.5)]
+ UseProxy,
/// 307 Temporary Redirect
- TemporaryRedirect = 307,
+ /// [[RFC7231, Section 6.4.7](https://tools.ietf.org/html/rfc7231#section-6.4.7)]
+ TemporaryRedirect,
/// 308 Permanent Redirect
- PermanentRedirect = 308,
- /// 309 (unregistered)
- Code309 = 309,
- /// 310 (unregistered)
- Code310 = 310,
- /// 311 (unregistered)
- Code311 = 311,
- /// 312 (unregistered)
- Code312 = 312,
- /// 313 (unregistered)
- Code313 = 313,
- /// 314 (unregistered)
- Code314 = 314,
- /// 315 (unregistered)
- Code315 = 315,
- /// 316 (unregistered)
- Code316 = 316,
- /// 317 (unregistered)
- Code317 = 317,
- /// 318 (unregistered)
- Code318 = 318,
- /// 319 (unregistered)
- Code319 = 319,
- /// 320 (unregistered)
- Code320 = 320,
- /// 321 (unregistered)
- Code321 = 321,
- /// 322 (unregistered)
- Code322 = 322,
- /// 323 (unregistered)
- Code323 = 323,
- /// 324 (unregistered)
- Code324 = 324,
- /// 325 (unregistered)
- Code325 = 325,
- /// 326 (unregistered)
- Code326 = 326,
- /// 327 (unregistered)
- Code327 = 327,
- /// 328 (unregistered)
- Code328 = 328,
- /// 329 (unregistered)
- Code329 = 329,
- /// 330 (unregistered)
- Code330 = 330,
- /// 331 (unregistered)
- Code331 = 331,
- /// 332 (unregistered)
- Code332 = 332,
- /// 333 (unregistered)
- Code333 = 333,
- /// 334 (unregistered)
- Code334 = 334,
- /// 335 (unregistered)
- Code335 = 335,
- /// 336 (unregistered)
- Code336 = 336,
- /// 337 (unregistered)
- Code337 = 337,
- /// 338 (unregistered)
- Code338 = 338,
- /// 339 (unregistered)
- Code339 = 339,
- /// 340 (unregistered)
- Code340 = 340,
- /// 341 (unregistered)
- Code341 = 341,
- /// 342 (unregistered)
- Code342 = 342,
- /// 343 (unregistered)
- Code343 = 343,
- /// 344 (unregistered)
- Code344 = 344,
- /// 345 (unregistered)
- Code345 = 345,
- /// 346 (unregistered)
- Code346 = 346,
- /// 347 (unregistered)
- Code347 = 347,
- /// 348 (unregistered)
- Code348 = 348,
- /// 349 (unregistered)
- Code349 = 349,
- /// 350 (unregistered)
- Code350 = 350,
- /// 351 (unregistered)
- Code351 = 351,
- /// 352 (unregistered)
- Code352 = 352,
- /// 353 (unregistered)
- Code353 = 353,
- /// 354 (unregistered)
- Code354 = 354,
- /// 355 (unregistered)
- Code355 = 355,
- /// 356 (unregistered)
- Code356 = 356,
- /// 357 (unregistered)
- Code357 = 357,
- /// 358 (unregistered)
- Code358 = 358,
- /// 359 (unregistered)
- Code359 = 359,
- /// 360 (unregistered)
- Code360 = 360,
- /// 361 (unregistered)
- Code361 = 361,
- /// 362 (unregistered)
- Code362 = 362,
- /// 363 (unregistered)
- Code363 = 363,
- /// 364 (unregistered)
- Code364 = 364,
- /// 365 (unregistered)
- Code365 = 365,
- /// 366 (unregistered)
- Code366 = 366,
- /// 367 (unregistered)
- Code367 = 367,
- /// 368 (unregistered)
- Code368 = 368,
- /// 369 (unregistered)
- Code369 = 369,
- /// 370 (unregistered)
- Code370 = 370,
- /// 371 (unregistered)
- Code371 = 371,
- /// 372 (unregistered)
- Code372 = 372,
- /// 373 (unregistered)
- Code373 = 373,
- /// 374 (unregistered)
- Code374 = 374,
- /// 375 (unregistered)
- Code375 = 375,
- /// 376 (unregistered)
- Code376 = 376,
- /// 377 (unregistered)
- Code377 = 377,
- /// 378 (unregistered)
- Code378 = 378,
- /// 379 (unregistered)
- Code379 = 379,
- /// 380 (unregistered)
- Code380 = 380,
- /// 381 (unregistered)
- Code381 = 381,
- /// 382 (unregistered)
- Code382 = 382,
- /// 383 (unregistered)
- Code383 = 383,
- /// 384 (unregistered)
- Code384 = 384,
- /// 385 (unregistered)
- Code385 = 385,
- /// 386 (unregistered)
- Code386 = 386,
- /// 387 (unregistered)
- Code387 = 387,
- /// 388 (unregistered)
- Code388 = 388,
- /// 389 (unregistered)
- Code389 = 389,
- /// 390 (unregistered)
- Code390 = 390,
- /// 391 (unregistered)
- Code391 = 391,
- /// 392 (unregistered)
- Code392 = 392,
- /// 393 (unregistered)
- Code393 = 393,
- /// 394 (unregistered)
- Code394 = 394,
- /// 395 (unregistered)
- Code395 = 395,
- /// 396 (unregistered)
- Code396 = 396,
- /// 397 (unregistered)
- Code397 = 397,
- /// 398 (unregistered)
- Code398 = 398,
- /// 399 (unregistered)
- Code399 = 399,
+ /// [[RFC7238](https://tools.ietf.org/html/rfc7238)]
+ PermanentRedirect,
/// 400 Bad Request
- BadRequest = 400,
+ /// [[RFC7231, Section 6.5.1](https://tools.ietf.org/html/rfc7231#section-6.5.1)]
+ BadRequest,
/// 401 Unauthorized
- Unauthorized = 401,
+ /// [[RFC7235, Section 3.1](https://tools.ietf.org/html/rfc7235#section-3.1)]
+ Unauthorized,
/// 402 Payment Required
- PaymentRequired = 402,
+ /// [[RFC7231, Section 6.5.2](https://tools.ietf.org/html/rfc7231#section-6.5.2)]
+ PaymentRequired,
/// 403 Forbidden
- Forbidden = 403,
+ /// [[RFC7231, Section 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3)]
+ Forbidden,
/// 404 Not Found
- NotFound = 404,
+ /// [[RFC7231, Section 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)]
+ NotFound,
/// 405 Method Not Allowed
- MethodNotAllowed = 405,
+ /// [[RFC7231, Section 6.5.5](https://tools.ietf.org/html/rfc7231#section-6.5.5)]
+ MethodNotAllowed,
/// 406 Not Acceptable
- NotAcceptable = 406,
+ /// [[RFC7231, Section 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)]
+ NotAcceptable,
/// 407 Proxy Authentication Required
- ProxyAuthenticationRequired = 407,
+ /// [[RFC7235, Section 3.2](https://tools.ietf.org/html/rfc7235#section-3.2)]
+ ProxyAuthenticationRequired,
/// 408 Request Timeout
- RequestTimeout = 408,
+ /// [[RFC7231, Section 6.5.7](https://tools.ietf.org/html/rfc7231#section-6.5.7)]
+ RequestTimeout,
/// 409 Conflict
- Conflict = 409,
+ /// [[RFC7231, Section 6.5.8](https://tools.ietf.org/html/rfc7231#section-6.5.8)]
+ Conflict,
/// 410 Gone
- Gone = 410,
+ /// [[RFC7231, Section 6.5.9](https://tools.ietf.org/html/rfc7231#section-6.5.9)]
+ Gone,
/// 411 Length Required
- LengthRequired = 411,
+ /// [[RFC7231, Section 6.5.10](https://tools.ietf.org/html/rfc7231#section-6.5.10)]
+ LengthRequired,
/// 412 Precondition Failed
- PreconditionFailed = 412,
- /// 413 Request Entity Too Large
- RequestEntityTooLarge = 413,
- /// 414 Request-URI Too Long
- RequestUriTooLong = 414,
+ /// [[RFC7232, Section 4.2](https://tools.ietf.org/html/rfc7232#section-4.2)]
+ PreconditionFailed,
+ /// 413 Payload Too Large
+ /// [[RFC7231, Section 6.5.11](https://tools.ietf.org/html/rfc7231#section-6.5.11)]
+ PayloadTooLarge,
+ /// 414 URI Too Long
+ /// [[RFC7231, Section 6.5.12](https://tools.ietf.org/html/rfc7231#section-6.5.12)]
+ UriTooLong,
/// 415 Unsupported Media Type
- UnsupportedMediaType = 415,
- /// 416 Requested Range Not Satisfiable
- RequestedRangeNotSatisfiable = 416,
+ /// [[RFC7231, Section 6.5.13](https://tools.ietf.org/html/rfc7231#section-6.5.13)]
+ UnsupportedMediaType,
+ /// 416 Range Not Satisfiable
+ /// [[RFC7233, Section 4.4](https://tools.ietf.org/html/rfc7233#section-4.4)]
+ RangeNotSatisfiable,
/// 417 Expectation Failed
- ExpectationFailed = 417,
+ /// [[RFC7231, Section 6.5.14](https://tools.ietf.org/html/rfc7231#section-6.5.14)]
+ ExpectationFailed,
/// 418 I'm a teapot
- ImATeapot = 418,
- /// 419 Authentication Timeout
- AuthenticationTimeout = 419,
- /// 420 (unregistered)
- Code420 = 420,
- /// 421 (unregistered)
- Code421 = 421,
+ /// [curiously, not registered by IANA, but [RFC2324](https://tools.ietf.org/html/rfc2324)]
+ ImATeapot,
+
/// 422 Unprocessable Entity
- UnprocessableEntity = 422,
+ /// [[RFC4918](https://tools.ietf.org/html/rfc4918)]
+ UnprocessableEntity,
/// 423 Locked
- Locked = 423,
+ /// [[RFC4918](https://tools.ietf.org/html/rfc4918)]
+ Locked,
/// 424 Failed Dependency
- FailedDependency = 424,
- /// 425 Unordered Collection
- UnorderedCollection = 425,
+ /// [[RFC4918](https://tools.ietf.org/html/rfc4918)]
+ FailedDependency,
+
/// 426 Upgrade Required
- UpgradeRequired = 426,
- /// 427 (unregistered)
- Code427 = 427,
+ /// [[RFC7231, Section 6.5.15](https://tools.ietf.org/html/rfc7231#section-6.5.15)]
+ UpgradeRequired,
+
/// 428 Precondition Required
- PreconditionRequired = 428,
+ /// [[RFC6585](https://tools.ietf.org/html/rfc6585)]
+ PreconditionRequired,
/// 429 Too Many Requests
- TooManyRequests = 429,
- /// 430 (unregistered)
- Code430 = 430,
+ /// [[RFC6585](https://tools.ietf.org/html/rfc6585)]
+ TooManyRequests,
+
/// 431 Request Header Fields Too Large
- RequestHeaderFieldsTooLarge = 431,
- /// 432 (unregistered)
- Code432 = 432,
- /// 433 (unregistered)
- Code433 = 433,
- /// 434 (unregistered)
- Code434 = 434,
- /// 435 (unregistered)
- Code435 = 435,
- /// 436 (unregistered)
- Code436 = 436,
- /// 437 (unregistered)
- Code437 = 437,
- /// 438 (unregistered)
- Code438 = 438,
- /// 439 (unregistered)
- Code439 = 439,
- /// 440 (unregistered)
- Code440 = 440,
- /// 441 (unregistered)
- Code441 = 441,
- /// 442 (unregistered)
- Code442 = 442,
- /// 443 (unregistered)
- Code443 = 443,
- /// 444 (unregistered)
- Code444 = 444,
- /// 445 (unregistered)
- Code445 = 445,
- /// 446 (unregistered)
- Code446 = 446,
- /// 447 (unregistered)
- Code447 = 447,
- /// 448 (unregistered)
- Code448 = 448,
- /// 449 (unregistered)
- Code449 = 449,
- /// 450 (unregistered)
- Code450 = 450,
- /// 451 Unavailable For Legal Reasons
- UnavailableForLegalReasons = 451,
- /// 452 (unregistered)
- Code452 = 452,
- /// 453 (unregistered)
- Code453 = 453,
- /// 454 (unregistered)
- Code454 = 454,
- /// 455 (unregistered)
- Code455 = 455,
- /// 456 (unregistered)
- Code456 = 456,
- /// 457 (unregistered)
- Code457 = 457,
- /// 458 (unregistered)
- Code458 = 458,
- /// 459 (unregistered)
- Code459 = 459,
- /// 460 (unregistered)
- Code460 = 460,
- /// 461 (unregistered)
- Code461 = 461,
- /// 462 (unregistered)
- Code462 = 462,
- /// 463 (unregistered)
- Code463 = 463,
- /// 464 (unregistered)
- Code464 = 464,
- /// 465 (unregistered)
- Code465 = 465,
- /// 466 (unregistered)
- Code466 = 466,
- /// 467 (unregistered)
- Code467 = 467,
- /// 468 (unregistered)
- Code468 = 468,
- /// 469 (unregistered)
- Code469 = 469,
- /// 470 (unregistered)
- Code470 = 470,
- /// 471 (unregistered)
- Code471 = 471,
- /// 472 (unregistered)
- Code472 = 472,
- /// 473 (unregistered)
- Code473 = 473,
- /// 474 (unregistered)
- Code474 = 474,
- /// 475 (unregistered)
- Code475 = 475,
- /// 476 (unregistered)
- Code476 = 476,
- /// 477 (unregistered)
- Code477 = 477,
- /// 478 (unregistered)
- Code478 = 478,
- /// 479 (unregistered)
- Code479 = 479,
- /// 480 (unregistered)
- Code480 = 480,
- /// 481 (unregistered)
- Code481 = 481,
- /// 482 (unregistered)
- Code482 = 482,
- /// 483 (unregistered)
- Code483 = 483,
- /// 484 (unregistered)
- Code484 = 484,
- /// 485 (unregistered)
- Code485 = 485,
- /// 486 (unregistered)
- Code486 = 486,
- /// 487 (unregistered)
- Code487 = 487,
- /// 488 (unregistered)
- Code488 = 488,
- /// 489 (unregistered)
- Code489 = 489,
- /// 490 (unregistered)
- Code490 = 490,
- /// 491 (unregistered)
- Code491 = 491,
- /// 492 (unregistered)
- Code492 = 492,
- /// 493 (unregistered)
- Code493 = 493,
- /// 494 (unregistered)
- Code494 = 494,
- /// 495 (unregistered)
- Code495 = 495,
- /// 496 (unregistered)
- Code496 = 496,
- /// 497 (unregistered)
- Code497 = 497,
- /// 498 (unregistered)
- Code498 = 498,
- /// 499 (unregistered)
- Code499 = 499,
+ /// [[RFC6585](https://tools.ietf.org/html/rfc6585)]
+ RequestHeaderFieldsTooLarge,
/// 500 Internal Server Error
- InternalServerError = 500,
+ /// [[RFC7231, Section 6.6.1](https://tools.ietf.org/html/rfc7231#section-6.6.1)]
+ InternalServerError,
/// 501 Not Implemented
- NotImplemented = 501,
+ /// [[RFC7231, Section 6.6.2](https://tools.ietf.org/html/rfc7231#section-6.6.2)]
+ NotImplemented,
/// 502 Bad Gateway
- BadGateway = 502,
+ /// [[RFC7231, Section 6.6.3](https://tools.ietf.org/html/rfc7231#section-6.6.3)]
+ BadGateway,
/// 503 Service Unavailable
- ServiceUnavailable = 503,
+ /// [[RFC7231, Section 6.6.4](https://tools.ietf.org/html/rfc7231#section-6.6.4)]
+ ServiceUnavailable,
/// 504 Gateway Timeout
- GatewayTimeout = 504,
+ /// [[RFC7231, Section 6.6.5](https://tools.ietf.org/html/rfc7231#section-6.6.5)]
+ GatewayTimeout,
/// 505 HTTP Version Not Supported
- HttpVersionNotSupported = 505,
+ /// [[RFC7231, Section 6.6.6](https://tools.ietf.org/html/rfc7231#section-6.6.6)]
+ HttpVersionNotSupported,
/// 506 Variant Also Negotiates
- VariantAlsoNegotiates = 506,
+ /// [[RFC2295](https://tools.ietf.org/html/rfc2295)]
+ VariantAlsoNegotiates,
/// 507 Insufficient Storage
- InsufficientStorage = 507,
+ /// [[RFC4918](https://tools.ietf.org/html/rfc4918)]
+ InsufficientStorage,
/// 508 Loop Detected
- LoopDetected = 508,
- /// 509 (unregistered)
- Code509 = 509,
+ /// [[RFC5842](https://tools.ietf.org/html/rfc5842)]
+ LoopDetected,
+
/// 510 Not Extended
- NotExtended = 510,
+ /// [[RFC2774](https://tools.ietf.org/html/rfc2774)]
+ NotExtended,
/// 511 Network Authentication Required
- NetworkAuthenticationRequired = 511,
- /// 512 (unregistered)
- Code512 = 512,
- /// 513 (unregistered)
- Code513 = 513,
- /// 514 (unregistered)
- Code514 = 514,
- /// 515 (unregistered)
- Code515 = 515,
- /// 516 (unregistered)
- Code516 = 516,
- /// 517 (unregistered)
- Code517 = 517,
- /// 518 (unregistered)
- Code518 = 518,
- /// 519 (unregistered)
- Code519 = 519,
- /// 520 (unregistered)
- Code520 = 520,
- /// 521 (unregistered)
- Code521 = 521,
- /// 522 (unregistered)
- Code522 = 522,
- /// 523 (unregistered)
- Code523 = 523,
- /// 524 (unregistered)
- Code524 = 524,
- /// 525 (unregistered)
- Code525 = 525,
- /// 526 (unregistered)
- Code526 = 526,
- /// 527 (unregistered)
- Code527 = 527,
- /// 528 (unregistered)
- Code528 = 528,
- /// 529 (unregistered)
- Code529 = 529,
- /// 530 (unregistered)
- Code530 = 530,
- /// 531 (unregistered)
- Code531 = 531,
- /// 532 (unregistered)
- Code532 = 532,
- /// 533 (unregistered)
- Code533 = 533,
- /// 534 (unregistered)
- Code534 = 534,
- /// 535 (unregistered)
- Code535 = 535,
- /// 536 (unregistered)
- Code536 = 536,
- /// 537 (unregistered)
- Code537 = 537,
- /// 538 (unregistered)
- Code538 = 538,
- /// 539 (unregistered)
- Code539 = 539,
- /// 540 (unregistered)
- Code540 = 540,
- /// 541 (unregistered)
- Code541 = 541,
- /// 542 (unregistered)
- Code542 = 542,
- /// 543 (unregistered)
- Code543 = 543,
- /// 544 (unregistered)
- Code544 = 544,
- /// 545 (unregistered)
- Code545 = 545,
- /// 546 (unregistered)
- Code546 = 546,
- /// 547 (unregistered)
- Code547 = 547,
- /// 548 (unregistered)
- Code548 = 548,
- /// 549 (unregistered)
- Code549 = 549,
- /// 550 (unregistered)
- Code550 = 550,
- /// 551 (unregistered)
- Code551 = 551,
- /// 552 (unregistered)
- Code552 = 552,
- /// 553 (unregistered)
- Code553 = 553,
- /// 554 (unregistered)
- Code554 = 554,
- /// 555 (unregistered)
- Code555 = 555,
- /// 556 (unregistered)
- Code556 = 556,
- /// 557 (unregistered)
- Code557 = 557,
- /// 558 (unregistered)
- Code558 = 558,
- /// 559 (unregistered)
- Code559 = 559,
- /// 560 (unregistered)
- Code560 = 560,
- /// 561 (unregistered)
- Code561 = 561,
- /// 562 (unregistered)
- Code562 = 562,
- /// 563 (unregistered)
- Code563 = 563,
- /// 564 (unregistered)
- Code564 = 564,
- /// 565 (unregistered)
- Code565 = 565,
- /// 566 (unregistered)
- Code566 = 566,
- /// 567 (unregistered)
- Code567 = 567,
- /// 568 (unregistered)
- Code568 = 568,
- /// 569 (unregistered)
- Code569 = 569,
- /// 570 (unregistered)
- Code570 = 570,
- /// 571 (unregistered)
- Code571 = 571,
- /// 572 (unregistered)
- Code572 = 572,
- /// 573 (unregistered)
- Code573 = 573,
- /// 574 (unregistered)
- Code574 = 574,
- /// 575 (unregistered)
- Code575 = 575,
- /// 576 (unregistered)
- Code576 = 576,
- /// 577 (unregistered)
- Code577 = 577,
- /// 578 (unregistered)
- Code578 = 578,
- /// 579 (unregistered)
- Code579 = 579,
- /// 580 (unregistered)
- Code580 = 580,
- /// 581 (unregistered)
- Code581 = 581,
- /// 582 (unregistered)
- Code582 = 582,
- /// 583 (unregistered)
- Code583 = 583,
- /// 584 (unregistered)
- Code584 = 584,
- /// 585 (unregistered)
- Code585 = 585,
- /// 586 (unregistered)
- Code586 = 586,
- /// 587 (unregistered)
- Code587 = 587,
- /// 588 (unregistered)
- Code588 = 588,
- /// 589 (unregistered)
- Code589 = 589,
- /// 590 (unregistered)
- Code590 = 590,
- /// 591 (unregistered)
- Code591 = 591,
- /// 592 (unregistered)
- Code592 = 592,
- /// 593 (unregistered)
- Code593 = 593,
- /// 594 (unregistered)
- Code594 = 594,
- /// 595 (unregistered)
- Code595 = 595,
- /// 596 (unregistered)
- Code596 = 596,
- /// 597 (unregistered)
- Code597 = 597,
- /// 598 (unregistered)
- Code598 = 598,
- /// 599 (unregistered)
- Code599 = 599,
+ /// [[RFC6585](https://tools.ietf.org/html/rfc6585)]
+ NetworkAuthenticationRequired,
+
+ /// A status code not in the IANA HTTP status code registry or very well known
+ // `ImATeapot` is not registered.
+ Unregistered(u16),
}
impl StatusCode {
- /// Get the standardised `Reason-Phrase` for this status code.
+ /// Get the standardised `reason-phrase` for this status code.
///
- /// This is mostly here for servers writing responses, but could potentially have application at
- /// other times.
+ /// This is mostly here for servers writing responses, but could potentially have application
+ /// at other times.
///
/// The reason phrase is defined as being exclusively for human readers. You should avoid
- /// derive any meaning from it at all costs.
+ /// deriving any meaning from it at all costs.
///
/// Bear in mind also that in HTTP/2.0 the reason phrase is abolished from transmission, and so
/// this canonical reason phrase really is the only reason phrase you’ll find.
@@ -1051,103 +238,6 @@ impl StatusCode {
StatusCode::Continue => Some("Continue"),
StatusCode::SwitchingProtocols => Some("Switching Protocols"),
StatusCode::Processing => Some("Processing"),
- StatusCode::Code103 => None,
- StatusCode::Code104 => None,
- StatusCode::Code105 => None,
- StatusCode::Code106 => None,
- StatusCode::Code107 => None,
- StatusCode::Code108 => None,
- StatusCode::Code109 => None,
- StatusCode::Code110 => None,
- StatusCode::Code111 => None,
- StatusCode::Code112 => None,
- StatusCode::Code113 => None,
- StatusCode::Code114 => None,
- StatusCode::Code115 => None,
- StatusCode::Code116 => None,
- StatusCode::Code117 => None,
- StatusCode::Code118 => None,
- StatusCode::Code119 => None,
- StatusCode::Code120 => None,
- StatusCode::Code121 => None,
- StatusCode::Code122 => None,
- StatusCode::Code123 => None,
- StatusCode::Code124 => None,
- StatusCode::Code125 => None,
- StatusCode::Code126 => None,
- StatusCode::Code127 => None,
- StatusCode::Code128 => None,
- StatusCode::Code129 => None,
- StatusCode::Code130 => None,
- StatusCode::Code131 => None,
- StatusCode::Code132 => None,
- StatusCode::Code133 => None,
- StatusCode::Code134 => None,
- StatusCode::Code135 => None,
- StatusCode::Code136 => None,
- StatusCode::Code137 => None,
- StatusCode::Code138 => None,
- StatusCode::Code139 => None,
- StatusCode::Code140 => None,
- StatusCode::Code141 => None,
- StatusCode::Code142 => None,
- StatusCode::Code143 => None,
- StatusCode::Code144 => None,
- StatusCode::Code145 => None,
- StatusCode::Code146 => None,
- StatusCode::Code147 => None,
- StatusCode::Code148 => None,
- StatusCode::Code149 => None,
- StatusCode::Code150 => None,
- StatusCode::Code151 => None,
- StatusCode::Code152 => None,
- StatusCode::Code153 => None,
- StatusCode::Code154 => None,
- StatusCode::Code155 => None,
- StatusCode::Code156 => None,
- StatusCode::Code157 => None,
- StatusCode::Code158 => None,
- StatusCode::Code159 => None,
- StatusCode::Code160 => None,
- StatusCode::Code161 => None,
- StatusCode::Code162 => None,
- StatusCode::Code163 => None,
- StatusCode::Code164 => None,
- StatusCode::Code165 => None,
- StatusCode::Code166 => None,
- StatusCode::Code167 => None,
- StatusCode::Code168 => None,
- StatusCode::Code169 => None,
- StatusCode::Code170 => None,
- StatusCode::Code171 => None,
- StatusCode::Code172 => None,
- StatusCode::Code173 => None,
- StatusCode::Code174 => None,
- StatusCode::Code175 => None,
- StatusCode::Code176 => None,
- StatusCode::Code177 => None,
- StatusCode::Code178 => None,
- StatusCode::Code179 => None,
- StatusCode::Code180 => None,
- StatusCode::Code181 => None,
- StatusCode::Code182 => None,
- StatusCode::Code183 => None,
- StatusCode::Code184 => None,
- StatusCode::Code185 => None,
- StatusCode::Code186 => None,
- StatusCode::Code187 => None,
- StatusCode::Code188 => None,
- StatusCode::Code189 => None,
- StatusCode::Code190 => None,
- StatusCode::Code191 => None,
- StatusCode::Code192 => None,
- StatusCode::Code193 => None,
- StatusCode::Code194 => None,
- StatusCode::Code195 => None,
- StatusCode::Code196 => None,
- StatusCode::Code197 => None,
- StatusCode::Code198 => None,
- StatusCode::Code199 => None,
StatusCode::Ok => Some("OK"),
StatusCode::Created => Some("Created"),
@@ -1158,97 +248,8 @@ impl StatusCode {
StatusCode::PartialContent => Some("Partial Content"),
StatusCode::MultiStatus => Some("Multi-Status"),
StatusCode::AlreadyReported => Some("Already Reported"),
- StatusCode::Code209 => None,
- StatusCode::Code210 => None,
- StatusCode::Code211 => None,
- StatusCode::Code212 => None,
- StatusCode::Code213 => None,
- StatusCode::Code214 => None,
- StatusCode::Code215 => None,
- StatusCode::Code216 => None,
- StatusCode::Code217 => None,
- StatusCode::Code218 => None,
- StatusCode::Code219 => None,
- StatusCode::Code220 => None,
- StatusCode::Code221 => None,
- StatusCode::Code222 => None,
- StatusCode::Code223 => None,
- StatusCode::Code224 => None,
- StatusCode::Code225 => None,
+
StatusCode::ImUsed => Some("IM Used"),
- StatusCode::Code227 => None,
- StatusCode::Code228 => None,
- StatusCode::Code229 => None,
- StatusCode::Code230 => None,
- StatusCode::Code231 => None,
- StatusCode::Code232 => None,
- StatusCode::Code233 => None,
- StatusCode::Code234 => None,
- StatusCode::Code235 => None,
- StatusCode::Code236 => None,
- StatusCode::Code237 => None,
- StatusCode::Code238 => None,
- StatusCode::Code239 => None,
- StatusCode::Code240 => None,
- StatusCode::Code241 => None,
- StatusCode::Code242 => None,
- StatusCode::Code243 => None,
- StatusCode::Code244 => None,
- StatusCode::Code245 => None,
- StatusCode::Code246 => None,
- StatusCode::Code247 => None,
- StatusCode::Code248 => None,
- StatusCode::Code249 => None,
- StatusCode::Code250 => None,
- StatusCode::Code251 => None,
- StatusCode::Code252 => None,
- StatusCode::Code253 => None,
- StatusCode::Code254 => None,
- StatusCode::Code255 => None,
- StatusCode::Code256 => None,
- StatusCode::Code257 => None,
- StatusCode::Code258 => None,
- StatusCode::Code259 => None,
- StatusCode::Code260 => None,
- StatusCode::Code261 => None,
- StatusCode::Code262 => None,
- StatusCode::Code263 => None,
- StatusCode::Code264 => None,
- StatusCode::Code265 => None,
- StatusCode::Code266 => None,
- StatusCode::Code267 => None,
- StatusCode::Code268 => None,
- StatusCode::Code269 => None,
- StatusCode::Code270 => None,
- StatusCode::Code271 => None,
- StatusCode::Code272 => None,
- StatusCode::Code273 => None,
- StatusCode::Code274 => None,
- StatusCode::Code275 => None,
- StatusCode::Code276 => None,
- StatusCode::Code277 => None,
- StatusCode::Code278 => None,
- StatusCode::Code279 => None,
- StatusCode::Code280 => None,
- StatusCode::Code281 => None,
- StatusCode::Code282 => None,
- StatusCode::Code283 => None,
- StatusCode::Code284 => None,
- StatusCode::Code285 => None,
- StatusCode::Code286 => None,
- StatusCode::Code287 => None,
- StatusCode::Code288 => None,
- StatusCode::Code289 => None,
- StatusCode::Code290 => None,
- StatusCode::Code291 => None,
- StatusCode::Code292 => None,
- StatusCode::Code293 => None,
- StatusCode::Code294 => None,
- StatusCode::Code295 => None,
- StatusCode::Code296 => None,
- StatusCode::Code297 => None,
- StatusCode::Code298 => None,
- StatusCode::Code299 => None,
StatusCode::MultipleChoices => Some("Multiple Choices"),
StatusCode::MovedPermanently => Some("Moved Permanently"),
@@ -1256,100 +257,9 @@ impl StatusCode {
StatusCode::SeeOther => Some("See Other"),
StatusCode::NotModified => Some("Not Modified"),
StatusCode::UseProxy => Some("Use Proxy"),
- StatusCode::SwitchProxy => Some("Switch Proxy"),
+
StatusCode::TemporaryRedirect => Some("Temporary Redirect"),
StatusCode::PermanentRedirect => Some("Permanent Redirect"),
- StatusCode::Code309 => None,
- StatusCode::Code310 => None,
- StatusCode::Code311 => None,
- StatusCode::Code312 => None,
- StatusCode::Code313 => None,
- StatusCode::Code314 => None,
- StatusCode::Code315 => None,
- StatusCode::Code316 => None,
- StatusCode::Code317 => None,
- StatusCode::Code318 => None,
- StatusCode::Code319 => None,
- StatusCode::Code320 => None,
- StatusCode::Code321 => None,
- StatusCode::Code322 => None,
- StatusCode::Code323 => None,
- StatusCode::Code324 => None,
- StatusCode::Code325 => None,
- StatusCode::Code326 => None,
- StatusCode::Code327 => None,
- StatusCode::Code328 => None,
- StatusCode::Code329 => None,
- StatusCode::Code330 => None,
- StatusCode::Code331 => None,
- StatusCode::Code332 => None,
- StatusCode::Code333 => None,
- StatusCode::Code334 => None,
- StatusCode::Code335 => None,
- StatusCode::Code336 => None,
- StatusCode::Code337 => None,
- StatusCode::Code338 => None,
- StatusCode::Code339 => None,
- StatusCode::Code340 => None,
- StatusCode::Code341 => None,
- StatusCode::Code342 => None,
- StatusCode::Code343 => None,
- StatusCode::Code344 => None,
- StatusCode::Code345 => None,
- StatusCode::Code346 => None,
- StatusCode::Code347 => None,
- StatusCode::Code348 => None,
- StatusCode::Code349 => None,
- StatusCode::Code350 => None,
- StatusCode::Code351 => None,
- StatusCode::Code352 => None,
- StatusCode::Code353 => None,
- StatusCode::Code354 => None,
- StatusCode::Code355 => None,
- StatusCode::Code356 => None,
- StatusCode::Code357 => None,
- StatusCode::Code358 => None,
- StatusCode::Code359 => None,
- StatusCode::Code360 => None,
- StatusCode::Code361 => None,
- StatusCode::Code362 => None,
- StatusCode::Code363 => None,
- StatusCode::Code364 => None,
- StatusCode::Code365 => None,
- StatusCode::Code366 => None,
- StatusCode::Code367 => None,
- StatusCode::Code368 => None,
- StatusCode::Code369 => None,
- StatusCode::Code370 => None,
- StatusCode::Code371 => None,
- StatusCode::Code372 => None,
- StatusCode::Code373 => None,
- StatusCode::Code374 => None,
- StatusCode::Code375 => None,
- StatusCode::Code376 => None,
- StatusCode::Code377 => None,
- StatusCode::Code378 => None,
- StatusCode::Code379 => None,
- StatusCode::Code380 => None,
- StatusCode::Code381 => None,
- StatusCode::Code382 => None,
- StatusCode::Code383 => None,
- StatusCode::Code384 => None,
- StatusCode::Code385 => None,
- StatusCode::Code386 => None,
- StatusCode::Code387 => None,
- StatusCode::Code388 => None,
- StatusCode::Code389 => None,
- StatusCode::Code390 => None,
- StatusCode::Code391 => None,
- StatusCode::Code392 => None,
- StatusCode::Code393 => None,
- StatusCode::Code394 => None,
- StatusCode::Code395 => None,
- StatusCode::Code396 => None,
- StatusCode::Code397 => None,
- StatusCode::Code398 => None,
- StatusCode::Code399 => None,
StatusCode::BadRequest => Some("Bad Request"),
StatusCode::Unauthorized => Some("Unauthorized"),
@@ -1364,93 +274,23 @@ impl StatusCode {
StatusCode::Gone => Some("Gone"),
StatusCode::LengthRequired => Some("Length Required"),
StatusCode::PreconditionFailed => Some("Precondition Failed"),
- StatusCode::RequestEntityTooLarge => Some("Request Entity Too Large"),
- StatusCode::RequestUriTooLong => Some("Request-URI Too Long"),
+ StatusCode::PayloadTooLarge => Some("Payload Too Large"),
+ StatusCode::UriTooLong => Some("URI Too Long"),
StatusCode::UnsupportedMediaType => Some("Unsupported Media Type"),
- StatusCode::RequestedRangeNotSatisfiable => Some("Requested Range Not Satisfiable"),
+ StatusCode::RangeNotSatisfiable => Some("Range Not Satisfiable"),
StatusCode::ExpectationFailed => Some("Expectation Failed"),
StatusCode::ImATeapot => Some("I'm a teapot"),
- StatusCode::AuthenticationTimeout => Some("Authentication Timeout"),
- StatusCode::Code420 => None,
- StatusCode::Code421 => None,
+
StatusCode::UnprocessableEntity => Some("Unprocessable Entity"),
StatusCode::Locked => Some("Locked"),
StatusCode::FailedDependency => Some("Failed Dependency"),
- StatusCode::UnorderedCollection => Some("Unordered Collection"),
+
StatusCode::UpgradeRequired => Some("Upgrade Required"),
- StatusCode::Code427 => None,
+
StatusCode::PreconditionRequired => Some("Precondition Required"),
StatusCode::TooManyRequests => Some("Too Many Requests"),
- StatusCode::Code430 => None,
+
StatusCode::RequestHeaderFieldsTooLarge => Some("Request Header Fields Too Large"),
- StatusCode::Code432 => None,
- StatusCode::Code433 => None,
- StatusCode::Code434 => None,
- StatusCode::Code435 => None,
- StatusCode::Code436 => None,
- StatusCode::Code437 => None,
- StatusCode::Code438 => None,
- StatusCode::Code439 => None,
- StatusCode::Code440 => None,
- StatusCode::Code441 => None,
- StatusCode::Code442 => None,
- StatusCode::Code443 => None,
- StatusCode::Code444 => None,
- StatusCode::Code445 => None,
- StatusCode::Code446 => None,
- StatusCode::Code447 => None,
- StatusCode::Code448 => None,
- StatusCode::Code449 => None,
- StatusCode::Code450 => None,
- StatusCode::UnavailableForLegalReasons => Some("Unavailable For Legal Reasons"),
- StatusCode::Code452 => None,
- StatusCode::Code453 => None,
- StatusCode::Code454 => None,
- StatusCode::Code455 => None,
- StatusCode::Code456 => None,
- StatusCode::Code457 => None,
- StatusCode::Code458 => None,
- StatusCode::Code459 => None,
- StatusCode::Code460 => None,
- StatusCode::Code461 => None,
- StatusCode::Code462 => None,
- StatusCode::Code463 => None,
- StatusCode::Code464 => None,
- StatusCode::Code465 => None,
- StatusCode::Code466 => None,
- StatusCode::Code467 => None,
- StatusCode::Code468 => None,
- StatusCode::Code469 => None,
- StatusCode::Code470 => None,
- StatusCode::Code471 => None,
- StatusCode::Code472 => None,
- StatusCode::Code473 => None,
- StatusCode::Code474 => None,
- StatusCode::Code475 => None,
- StatusCode::Code476 => None,
- StatusCode::Code477 => None,
- StatusCode::Code478 => None,
- StatusCode::Code479 => None,
- StatusCode::Code480 => None,
- StatusCode::Code481 => None,
- StatusCode::Code482 => None,
- StatusCode::Code483 => None,
- StatusCode::Code484 => None,
- StatusCode::Code485 => None,
- StatusCode::Code486 => None,
- StatusCode::Code487 => None,
- StatusCode::Code488 => None,
- StatusCode::Code489 => None,
- StatusCode::Code490 => None,
- StatusCode::Code491 => None,
- StatusCode::Code492 => None,
- StatusCode::Code493 => None,
- StatusCode::Code494 => None,
- StatusCode::Code495 => None,
- StatusCode::Code496 => None,
- StatusCode::Code497 => None,
- StatusCode::Code498 => None,
- StatusCode::Code499 => None,
StatusCode::InternalServerError => Some("Internal Server Error"),
StatusCode::NotImplemented => Some("Not Implemented"),
@@ -1461,114 +301,22 @@ impl StatusCode {
StatusCode::VariantAlsoNegotiates => Some("Variant Also Negotiates"),
StatusCode::InsufficientStorage => Some("Insufficient Storage"),
StatusCode::LoopDetected => Some("Loop Detected"),
- StatusCode::Code509 => None,
+
StatusCode::NotExtended => Some("Not Extended"),
StatusCode::NetworkAuthenticationRequired => Some("Network Authentication Required"),
- StatusCode::Code512 => None,
- StatusCode::Code513 => None,
- StatusCode::Code514 => None,
- StatusCode::Code515 => None,
- StatusCode::Code516 => None,
- StatusCode::Code517 => None,
- StatusCode::Code518 => None,
- StatusCode::Code519 => None,
- StatusCode::Code520 => None,
- StatusCode::Code521 => None,
- StatusCode::Code522 => None,
- StatusCode::Code523 => None,
- StatusCode::Code524 => None,
- StatusCode::Code525 => None,
- StatusCode::Code526 => None,
- StatusCode::Code527 => None,
- StatusCode::Code528 => None,
- StatusCode::Code529 => None,
- StatusCode::Code530 => None,
- StatusCode::Code531 => None,
- StatusCode::Code532 => None,
- StatusCode::Code533 => None,
- StatusCode::Code534 => None,
- StatusCode::Code535 => None,
- StatusCode::Code536 => None,
- StatusCode::Code537 => None,
- StatusCode::Code538 => None,
- StatusCode::Code539 => None,
- StatusCode::Code540 => None,
- StatusCode::Code541 => None,
- StatusCode::Code542 => None,
- StatusCode::Code543 => None,
- StatusCode::Code544 => None,
- StatusCode::Code545 => None,
- StatusCode::Code546 => None,
- StatusCode::Code547 => None,
- StatusCode::Code548 => None,
- StatusCode::Code549 => None,
- StatusCode::Code550 => None,
- StatusCode::Code551 => None,
- StatusCode::Code552 => None,
- StatusCode::Code553 => None,
- StatusCode::Code554 => None,
- StatusCode::Code555 => None,
- StatusCode::Code556 => None,
- StatusCode::Code557 => None,
- StatusCode::Code558 => None,
- StatusCode::Code559 => None,
- StatusCode::Code560 => None,
- StatusCode::Code561 => None,
- StatusCode::Code562 => None,
- StatusCode::Code563 => None,
- StatusCode::Code564 => None,
- StatusCode::Code565 => None,
- StatusCode::Code566 => None,
- StatusCode::Code567 => None,
- StatusCode::Code568 => None,
- StatusCode::Code569 => None,
- StatusCode::Code570 => None,
- StatusCode::Code571 => None,
- StatusCode::Code572 => None,
- StatusCode::Code573 => None,
- StatusCode::Code574 => None,
- StatusCode::Code575 => None,
- StatusCode::Code576 => None,
- StatusCode::Code577 => None,
- StatusCode::Code578 => None,
- StatusCode::Code579 => None,
- StatusCode::Code580 => None,
- StatusCode::Code581 => None,
- StatusCode::Code582 => None,
- StatusCode::Code583 => None,
- StatusCode::Code584 => None,
- StatusCode::Code585 => None,
- StatusCode::Code586 => None,
- StatusCode::Code587 => None,
- StatusCode::Code588 => None,
- StatusCode::Code589 => None,
- StatusCode::Code590 => None,
- StatusCode::Code591 => None,
- StatusCode::Code592 => None,
- StatusCode::Code593 => None,
- StatusCode::Code594 => None,
- StatusCode::Code595 => None,
- StatusCode::Code596 => None,
- StatusCode::Code597 => None,
- StatusCode::Code598 => None,
- StatusCode::Code599 => None,
+ _ => None
}
}
/// Determine the class of a status code, based on its first digit.
pub fn class(&self) -> StatusClass {
- let code = *self as u16; // Range of possible values: 100..599.
- // We could match 100..199 &c., but this way we avoid unreachable!() at the end.
- if code < 200 {
- StatusClass::Informational
- } else if code < 300 {
- StatusClass::Success
- } else if code < 400 {
- StatusClass::Redirection
- } else if code < 500 {
- StatusClass::ClientError
- } else {
- StatusClass::ServerError
+ match self.to_u16().unwrap() {
+ 100...199 => StatusClass::Informational,
+ 200...299 => StatusClass::Success,
+ 300...399 => StatusClass::Redirection,
+ 400...499 => StatusClass::ClientError,
+ 500...599 => StatusClass::ServerError,
+ _ => StatusClass::NoClass,
}
}
@@ -1596,6 +344,11 @@ impl StatusCode {
pub fn is_server_error(&self) -> bool {
self.class() == StatusClass::ServerError
}
+
+ /// Check if class is NoClass
+ pub fn is_strange_status(&self) -> bool {
+ self.class() == StatusClass::NoClass
+ }
}
impl Copy for StatusCode {}
@@ -1603,36 +356,120 @@ impl Copy for StatusCode {}
/// Formats the status code, *including* the canonical reason.
///
/// ```rust
-/// # use hyper::status::StatusCode::{ImATeapot, Code123};
-/// # #[allow(unstable)]
-/// # fn main() {
-/// assert_eq!(&format!("{}", ImATeapot)[],
+/// # use hyper::status::StatusCode::{ImATeapot, Unregistered};
+/// assert_eq!(format!("{}", ImATeapot).as_slice(),
/// "418 I'm a teapot");
-/// assert_eq!(&format!("{}", Code123)[],
+/// assert_eq!(format!("{}", Unregistered(123)).as_slice(),
/// "123 <unknown status code>");
-/// # }
/// ```
///
-/// If you wish to just include the number, cast to a u16 instead.
+/// If you wish to just include the number, convert to `u16` instead:
+///
+/// ```rust
+/// # use std::num::ToPrimitive;
+/// # use hyper::status::StatusCode::{ImATeapot, Unregistered};
+/// assert_eq!(format!("{}", ImATeapot.to_u16().unwrap()).as_slice(), "418");
+/// assert_eq!(format!("{}", Unregistered(123).to_u16().unwrap()).as_slice(), "123");
+/// ```
impl fmt::Display for StatusCode {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
- write!(f, "{} {}", *self as u16,
+ write!(f, "{} {}", self.to_u16().unwrap(),
self.canonical_reason().unwrap_or("<unknown status code>"))
}
}
-// Specified manually because the codegen for derived is slow (at the time of writing on the machine
-// of writing, 1.2 seconds) and verbose (though the optimiser cuts it down to size).
+impl fmt::Debug for StatusCode {
+ fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+ // TODO
+ match *self {
+ StatusCode::Unregistered(ref code) => {
+ write!(f, "Unregistered{}", code)
+ },
+ _ => f.write_str(match *self {
+ StatusCode::Continue => "Continue",
+ StatusCode::SwitchingProtocols => "SwitchingProtocols",
+ StatusCode::Processing => "Processing",
+
+ StatusCode::Ok => "Ok",
+ StatusCode::Created => "Created",
+ StatusCode::Accepted => "Accepted",
+ StatusCode::NonAuthoritativeInformation => "NonAuthoritativeInformation",
+ StatusCode::NoContent => "NoContent",
+ StatusCode::ResetContent => "ResetContent",
+ StatusCode::PartialContent => "PartialContent",
+ StatusCode::MultiStatus => "MultiStatus",
+ StatusCode::AlreadyReported => "AlreadyReported",
+
+ StatusCode::ImUsed => "ImUsed",
+
+ StatusCode::MultipleChoices => "MultipleChoices",
+ StatusCode::MovedPermanently => "MovedPermanently",
+ StatusCode::Found => "Found",
+ StatusCode::SeeOther => "SeeOther",
+ StatusCode::NotModified => "NotModified",
+ StatusCode::UseProxy => "UseProxy",
+
+ StatusCode::TemporaryRedirect => "TemporaryRedirect",
+ StatusCode::PermanentRedirect => "PermanentRedirect",
+
+ StatusCode::BadRequest => "BadRequest",
+ StatusCode::Unauthorized => "Unauthorized",
+ StatusCode::PaymentRequired => "PaymentRequired",
+ StatusCode::Forbidden => "Forbidden",
+ StatusCode::NotFound => "NotFound",
+ StatusCode::MethodNotAllowed => "MethodNotAllowed",
+ StatusCode::NotAcceptable => "NotAcceptable",
+ StatusCode::ProxyAuthenticationRequired => "ProxyAuthenticationRequired",
+ StatusCode::RequestTimeout => "RequestTimeout",
+ StatusCode::Conflict => "Conflict",
+ StatusCode::Gone => "Gone",
+ StatusCode::LengthRequired => "LengthRequired",
+ StatusCode::PreconditionFailed => "PreconditionFailed",
+ StatusCode::PayloadTooLarge => "PayloadTooLarge",
+ StatusCode::UriTooLong => "UriTooLong",
+ StatusCode::UnsupportedMediaType => "UnsupportedMediaType",
+ StatusCode::RangeNotSatisfiable => "RangeNotSatisfiable",
+ StatusCode::ExpectationFailed => "ExpectationFailed",
+ StatusCode::ImATeapot => "ImATeapot",
+
+ StatusCode::UnprocessableEntity => "UnprocessableEntity",
+ StatusCode::Locked => "Locked",
+ StatusCode::FailedDependency => "FailedDependency",
+
+ StatusCode::UpgradeRequired => "UpgradeRequired",
+
+ StatusCode::PreconditionRequired => "PreconditionRequired",
+ StatusCode::TooManyRequests => "TooManyRequests",
+
+ StatusCode::RequestHeaderFieldsTooLarge => "RequestHeaderFieldsTooLarge",
+
+ StatusCode::InternalServerError => "InternalServerError",
+ StatusCode::NotImplemented => "NotImplemented",
+ StatusCode::BadGateway => "BadGateway",
+ StatusCode::ServiceUnavailable => "ServiceUnavailable",
+ StatusCode::GatewayTimeout => "GatewayTimeout",
+ StatusCode::HttpVersionNotSupported => "HttpVersionNotSupported",
+ StatusCode::VariantAlsoNegotiates => "VariantAlsoNegotiates",
+ StatusCode::InsufficientStorage => "InsufficientStorage",
+ StatusCode::LoopDetected => "LoopDetected",
+
+ StatusCode::NotExtended => "NotExtended",
+ StatusCode::NetworkAuthenticationRequired => "NetworkAuthenticationRequired",
+ _ => unreachable!(),
+ })
+ }
+ }
+}
+
impl PartialEq for StatusCode {
#[inline]
fn eq(&self, other: &StatusCode) -> bool {
- *self as u16 == *other as u16
+ self.to_u16() == other.to_u16()
}
}
impl Eq for StatusCode {}
-// Ditto (though #[derive(Clone)] only takes about 0.4 seconds).
impl Clone for StatusCode {
#[inline]
fn clone(&self) -> StatusCode {
@@ -1640,22 +477,80 @@ impl Clone for StatusCode {
}
}
-// Of the other common derivable traits, I didn’t measure them, but I guess they would be slow too.
-
impl FromPrimitive for StatusCode {
fn from_i64(n: i64) -> Option<StatusCode> {
- if n < 100 || n > 599 {
+ if n < 0 {
None
} else {
- Some(unsafe { transmute::<u16, StatusCode>(n as u16) })
+ FromPrimitive::from_u64(n as u64)
}
}
fn from_u64(n: u64) -> Option<StatusCode> {
- if n < 100 || n > 599 {
+ if n > 65535 {
None
} else {
- Some(unsafe { transmute::<u16, StatusCode>(n as u16) })
+ Some(match n {
+ 100 => StatusCode::Continue,
+ 101 => StatusCode::SwitchingProtocols,
+ 102 => StatusCode::Processing,
+ 200 => StatusCode::Ok,
+ 201 => StatusCode::Created,
+ 202 => StatusCode::Accepted,
+ 203 => StatusCode::NonAuthoritativeInformation,
+ 204 => StatusCode::NoContent,
+ 205 => StatusCode::ResetContent,
+ 206 => StatusCode::PartialContent,
+ 207 => StatusCode::MultiStatus,
+ 208 => StatusCode::AlreadyReported,
+ 226 => StatusCode::ImUsed,
+ 300 => StatusCode::MultipleChoices,
+ 301 => StatusCode::MovedPermanently,
+ 302 => StatusCode::Found,
+ 303 => StatusCode::SeeOther,
+ 304 => StatusCode::NotModified,
+ 305 => StatusCode::UseProxy,
+ 307 => StatusCode::TemporaryRedirect,
+ 308 => StatusCode::PermanentRedirect,
+ 400 => StatusCode::BadRequest,
+ 401 => StatusCode::Unauthorized,
+ 402 => StatusCode::PaymentRequired,
+ 403 => StatusCode::Forbidden,
+ 404 => StatusCode::NotFound,
+ 405 => StatusCode::MethodNotAllowed,
+ 406 => StatusCode::NotAcceptable,
+ 407 => StatusCode::ProxyAuthenticationRequired,
+ 408 => StatusCode::RequestTimeout,
+ 409 => StatusCode::Conflict,
+ 410 => StatusCode::Gone,
+ 411 => StatusCode::LengthRequired,
+ 412 => StatusCode::PreconditionFailed,
+ 413 => StatusCode::PayloadTooLarge,
+ 414 => StatusCode::UriTooLong,
+ 415 => StatusCode::UnsupportedMediaType,
+ 416 => StatusCode::RangeNotSatisfiable,
+ 417 => StatusCode::ExpectationFailed,
+ 418 => StatusCode::ImATeapot,
+ 422 => StatusCode::UnprocessableEntity,
+ 423 => StatusCode::Locked,
+ 424 => StatusCode::FailedDependency,
+ 426 => StatusCode::UpgradeRequired,
+ 428 => StatusCode::PreconditionRequired,
+ 429 => StatusCode::TooManyRequests,
+ 431 => StatusCode::RequestHeaderFieldsTooLarge,
+ 500 => StatusCode::InternalServerError,
+ 501 => StatusCode::NotImplemented,
+ 502 => StatusCode::BadGateway,
+ 503 => StatusCode::ServiceUnavailable,
+ 504 => StatusCode::GatewayTimeout,
+ 505 => StatusCode::HttpVersionNotSupported,
+ 506 => StatusCode::VariantAlsoNegotiates,
+ 507 => StatusCode::InsufficientStorage,
+ 508 => StatusCode::LoopDetected,
+ 510 => StatusCode::NotExtended,
+ 511 => StatusCode::NetworkAuthenticationRequired,
+ _ => StatusCode::Unregistered(n as u16),
+ })
}
}
}
@@ -1663,7 +558,7 @@ impl FromPrimitive for StatusCode {
impl PartialOrd for StatusCode {
#[inline]
fn partial_cmp(&self, other: &StatusCode) -> Option<Ordering> {
- (*self as u16).partial_cmp(&(*other as u16))
+ self.to_u16().unwrap().partial_cmp(&(other.to_u16().unwrap()))
}
}
@@ -1671,76 +566,136 @@ impl Ord for StatusCode {
#[inline]
fn cmp(&self, other: &StatusCode) -> Ordering {
if *self < *other {
- Less
+ Ordering::Less
} else if *self > *other {
- Greater
+ Ordering::Greater
} else {
- Equal
+ Ordering::Equal
}
}
}
impl ToPrimitive for StatusCode {
fn to_i64(&self) -> Option<i64> {
- Some(*self as i64)
+ Some(self.to_u64().unwrap() as i64)
}
fn to_u64(&self) -> Option<u64> {
- Some(*self as u64)
+ Some(match *self {
+ StatusCode::Continue => 100,
+ StatusCode::SwitchingProtocols => 101,
+ StatusCode::Processing => 102,
+ StatusCode::Ok => 200,
+ StatusCode::Created => 201,
+ StatusCode::Accepted => 202,
+ StatusCode::NonAuthoritativeInformation => 203,
+ StatusCode::NoContent => 204,
+ StatusCode::ResetContent => 205,
+ StatusCode::PartialContent => 206,
+ StatusCode::MultiStatus => 207,
+ StatusCode::AlreadyReported => 208,
+ StatusCode::ImUsed => 226,
+ StatusCode::MultipleChoices => 300,
+ StatusCode::MovedPermanently => 301,
+ StatusCode::Found => 302,
+ StatusCode::SeeOther => 303,
+ StatusCode::NotModified => 304,
+ StatusCode::UseProxy => 305,
+ StatusCode::TemporaryRedirect => 307,
+ StatusCode::PermanentRedirect => 308,
+ StatusCode::BadRequest => 400,
+ StatusCode::Unauthorized => 401,
+ StatusCode::PaymentRequired => 402,
+ StatusCode::Forbidden => 403,
+ StatusCode::NotFound => 404,
+ StatusCode::MethodNotAllowed => 405,
+ StatusCode::NotAcceptable => 406,
+ StatusCode::ProxyAuthenticationRequired => 407,
+ StatusCode::RequestTimeout => 408,
+ StatusCode::Conflict => 409,
+ StatusCode::Gone => 410,
+ StatusCode::LengthRequired => 411,
+ StatusCode::PreconditionFailed => 412,
+ StatusCode::PayloadTooLarge => 413,
+ StatusCode::UriTooLong => 414,
+ StatusCode::UnsupportedMediaType => 415,
+ StatusCode::RangeNotSatisfiable => 416,
+ StatusCode::ExpectationFailed => 417,
+ StatusCode::ImATeapot => 418,
+ StatusCode::UnprocessableEntity => 422,
+ StatusCode::Locked => 423,
+ StatusCode::FailedDependency => 424,
+ StatusCode::UpgradeRequired => 426,
+ StatusCode::PreconditionRequired => 428,
+ StatusCode::TooManyRequests => 429,
+ StatusCode::RequestHeaderFieldsTooLarge => 431,
+ StatusCode::InternalServerError => 500,
+ StatusCode::NotImplemented => 501,
+ StatusCode::BadGateway => 502,
+ StatusCode::ServiceUnavailable => 503,
+ StatusCode::GatewayTimeout => 504,
+ StatusCode::HttpVersionNotSupported => 505,
+ StatusCode::VariantAlsoNegotiates => 506,
+ StatusCode::InsufficientStorage => 507,
+ StatusCode::LoopDetected => 508,
+ StatusCode::NotExtended => 510,
+ StatusCode::NetworkAuthenticationRequired => 511,
+ StatusCode::Unregistered(n) => n,
+ } as u64)
}
}
-/// The class of an HTTP `Status-Code`.
+/// The class of an HTTP `status-code`.
///
-/// [RFC 2616, section 6.1.1 (Status Code and Reason
-/// Phrase)](https://tools.ietf.org/html/rfc2616#section-6.1.1):
+/// [RFC 7231, section 6 (Response Status Codes)](https://tools.ietf.org/html/rfc7231#section-6):
///
-/// > The first digit of the Status-Code defines the class of response. The
-/// > last two digits do not have any categorization role.
-/// >
-/// > ...
-/// >
-/// > HTTP status codes are extensible. HTTP applications are not required
-/// > to understand the meaning of all registered status codes, though such
-/// > understanding is obviously desirable. However, applications MUST
+/// > The first digit of the status-code defines the class of response.
+/// > The last two digits do not have any categorization role.
+///
+/// And:
+///
+/// > HTTP status codes are extensible. HTTP clients are not required to
+/// > understand the meaning of all registered status codes, though such
+/// > understanding is obviously desirable. However, a client MUST
/// > understand the class of any status code, as indicated by the first
-/// > digit, and treat any unrecognized response as being equivalent to the
-/// > x00 status code of that class, with the exception that an
-/// > unrecognized response MUST NOT be cached. For example, if an
-/// > unrecognized status code of 431 is received by the client, it can
-/// > safely assume that there was something wrong with its request and
-/// > treat the response as if it had received a 400 status code. In such
-/// > cases, user agents SHOULD present to the user the entity returned
-/// > with the response, since that entity is likely to include human-
-/// > readable information which will explain the unusual status.
+/// > digit, and treat an unrecognized status code as being equivalent to
+/// > the x00 status code of that class, with the exception that a
+/// > recipient MUST NOT cache a response with an unrecognized status code.
+/// >
+/// > For example, if an unrecognized status code of 471 is received by a
+/// > client, the client can assume that there was something wrong with its
+/// > request and treat the response as if it had received a 400 (Bad
+/// > Request) status code. The response message will usually contain a
+/// > representation that explains the status.
///
/// This can be used in cases where a status code’s meaning is unknown, also,
/// to get the appropriate *category* of status.
-///
-/// For HTTP/2.0, the 1xx Informational class is invalid.
#[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Copy)]
pub enum StatusClass {
- /// 1xx: Informational - Request received, continuing process
- Informational = 100,
+ /// 1xx (Informational): The request was received, continuing process
+ Informational,
+
+ /// 2xx (Success): The request was successfully received, understood, and accepted
+ Success,
- /// 2xx: Success - The action was successfully received, understood, and accepted
- Success = 200,
+ /// 3xx (Redirection): Further action needs to be taken in order to complete the request
+ Redirection,
- /// 3xx: Redirection - Further action must be taken in order to complete the request
- Redirection = 300,
+ /// 4xx (Client Error): The request contains bad syntax or cannot be fulfilled
+ ClientError,
- /// 4xx: Client Error - The request contains bad syntax or cannot be fulfilled
- ClientError = 400,
+ /// 5xx (Server Error): The server failed to fulfill an apparently valid request
+ ServerError,
- /// 5xx: Server Error - The server failed to fulfill an apparently valid request
- ServerError = 500,
+ /// A status code lower than 100 or higher than 599. These codes do no belong to any class.
+ NoClass,
}
impl StatusClass {
/// Get the default status code for the class.
///
- /// This produces the x00 status code; thus, for `ClientError` (4xx), for example, this will
- /// produce `BadRequest` (400):
+ /// This produces the x00 status code; thus, for `ClientError` (4xx), for
+ /// example, this will produce `BadRequest` (400):
///
/// ```rust
/// # use hyper::status::StatusClass::ClientError;
@@ -1748,29 +703,30 @@ impl StatusClass {
/// assert_eq!(ClientError.default_code(), BadRequest);
/// ```
///
- /// The use for this is outlined in [RFC 2616, section 6.1.1 (Status Code and Reason
- /// Phrase)](https://tools.ietf.org/html/rfc2616#section-6.1.1):
+ /// The use for this is outlined in [RFC 7231, section 6 (Response Status
+ /// Codes)](https://tools.ietf.org/html/rfc7231#section-6):
///
- /// > HTTP status codes are extensible. HTTP applications are not required
- /// > to understand the meaning of all registered status codes, though such
- /// > understanding is obviously desirable. However, applications MUST
+ /// > HTTP status codes are extensible. HTTP clients are not required to
+ /// > understand the meaning of all registered status codes, though such
+ /// > understanding is obviously desirable. However, a client MUST
/// > understand the class of any status code, as indicated by the first
- /// > digit, and treat any unrecognized response as being equivalent to the
- /// > x00 status code of that class, with the exception that an
- /// > unrecognized response MUST NOT be cached. For example, if an
- /// > unrecognized status code of 431 is received by the client, it can
- /// > safely assume that there was something wrong with its request and
- /// > treat the response as if it had received a 400 status code. In such
- /// > cases, user agents SHOULD present to the user the entity returned
- /// > with the response, since that entity is likely to include human-
- /// > readable information which will explain the unusual status.
+ /// > digit, and treat an unrecognized status code as being equivalent to
+ /// > the x00 status code of that class, with the exception that a
+ /// > recipient MUST NOT cache a response with an unrecognized status code.
+ /// >
+ /// > For example, if an unrecognized status code of 471 is received by a
+ /// > client, the client can assume that there was something wrong with its
+ /// > request and treat the response as if it had received a 400 (Bad
+ /// > Request) status code. The response message will usually contain a
+ /// > representation that explains the status.
///
- /// This is demonstrated thusly (I’ll use 432 rather than 431 as 431 *is* now in use):
+ /// This is demonstrated thusly:
///
/// ```rust
- /// # use hyper::status::StatusCode::{Code432, BadRequest};
+ /// # use hyper::status::StatusCode::{Unregistered, BadRequest};
/// // Suppose we have received this status code.
- /// let status = Code432;
+ /// // You will never directly create an unregistered status code.
+ /// let status = Unregistered(471);
///
/// // Uh oh! Don’t know what to do with it.
/// // Let’s fall back to the default:
@@ -1780,18 +736,34 @@ impl StatusClass {
/// assert_eq!(status, BadRequest);
/// // So now let’s treat it as that.
/// ```
- #[inline]
+ /// All status codes that do not map to an existing status class are matched
+ /// by a `NoClass`, variant that resolves to 200 (Ok) as default code.
+ /// This is a common handling for unknown status codes in major browsers.
pub fn default_code(&self) -> StatusCode {
- unsafe { transmute::<StatusClass, StatusCode>(*self) }
+ match *self {
+ StatusClass::Informational => StatusCode::Continue,
+ StatusClass::Success => StatusCode::Ok,
+ StatusClass::Redirection => StatusCode::MultipleChoices,
+ StatusClass::ClientError => StatusCode::BadRequest,
+ StatusClass::ServerError => StatusCode::InternalServerError,
+ StatusClass::NoClass => StatusCode::Ok,
+ }
}
}
impl ToPrimitive for StatusClass {
fn to_i64(&self) -> Option<i64> {
- Some(*self as i64)
+ Some(self.to_u64().unwrap() as i64)
}
fn to_u64(&self) -> Option<u64> {
- Some(*self as u64)
+ Some(match *self {
+ StatusClass::Informational => 100,
+ StatusClass::Success => 200,
+ StatusClass::Redirection => 300,
+ StatusClass::ClientError => 400,
+ StatusClass::ServerError => 500,
+ StatusClass::NoClass => 200,
+ })
}
}