A Swift struct for working with HTTP status codes. Part of the Fly framework.
HTTPStatus provides named constants for the status codes you are likely to need:
HTTPStatus.OK, HTTPStatus.NotFound, HTTPStatus.InternalServerError, and many more.
To use the provided status codes:
var internalError = HTTPStatus.InternalServerError
// Since the type is known, we can omit `HTTPStatus` and use type inferrence:
internalError = .InternalServerError
// You can also assign a value with a status code number diretly due to `IntegerLiteralConvertible`:
internalError = 500
// But be careful! The code you use as a literal must be valid or the app will crash!
// A valid code is considered to be anything in the range of 100 through 599
let crashy: HTTPStatus = 99
// precondition failed: Status Code must be between 100 and 599However, if you need to use a status code that is not predefined, you can do so:
// returns an optional, only nil if the status code is outside of the valid range.
HTTPStatus(code: 199, message: "Very Informational Thing")
// returns non-optional HTTPStatus
// but will crash with `precondition failed` if the code is outside of the valid range
HTTPStatus(safeCode: 199, message: "Very Informational Thing")HTTPStatus is Equatable:
print(HTTPStatus.OK == 200) // true
print(.NotFound == 500) // false
// ^ Swift can even infer the type without extra context here :)HTTPStatus is CustomStringConvertible:
String(HTTPStatus.InternalServerError) // "500 Internal Server Error"
"\(HTTPStatus.NotFound)" // "404 Not Found"HTTPStatus is Hashable so it can be used as a dictionary key:
let statusDictionary: [HTTPStatus: String]Other minutiae:
// initializing a valid code that is not known to this library will work
// but will result in an "Unknown" message:
let custom: HTTPStatus = 199
String(custom) // "199 Unknown"
// You cannot override a built-in status message
let good = HTTPStatus(code: 200, message: "Very Good")
String(good) // "200 OK"- Add classification enum and logic to represent the different status type ranges