SweetURLRequest

SweetURLRequest simplifies common cases for creating an URLRequest and handling HTTPURLResponse.

Extensions for URLRequest:

⚡ Constants for HTTP methods
⚡ Properties to set common HTTP headers
⚡ URL/Form/JSON encoded parameters

Extensions for HTTPURLResponse:

⚡ Check for a 2xx success status code
⚡ Handle HTTP status codes via switch/case
⚡ Error enum for HTTP status codes

Examples

Example project

MetMuseumEndpoints: A Swift package for the The Metropolitan Museum of Art Collection API

Constants for HTTP methods

URLRequest(
    method: .post,
    url: URL(string: "http://www.example.com")!
)
Swift

Properties to set common HTTP headers

var request = URLRequest(url: URL(string: "http://www.example.com")!)
request.headers.accept = .json
request.headers.contentType = .xml
request.headers.authorization = "Bearer xyz"
Swift

URL/Form/JSON encoded parameters

Parameters will be URL-encoded for GET/HEAD/DELETE and sent as application/x-www-form-urlencoded body for other methods by default:

URLRequest(
    method: .get,
    url: URL(string: "http://www.example.com")!,
    parameters: ["param1" : "äöü", "param2" : "foo bar"]
)
Swift

You can also pass a JSON body, this will use JSONEncoder to serialize the given data and set an appropriate Content-Type header:

try URLRequest(
    method: .post,
    url: URL(string: "http://www.example.com")!,
    jsonBody: Person(name: "Bob")
)
Swift

Check for a success status code in the 2xx range

func expectSuccess(response: URLResponse) throws {
    let status = (response as! HTTPURLResponse).status
    guard status.responseType == .success else { throw status }
}
Swift

Handle HTTP status codes via switch/case, throw a status code as Error

func validate(response: URLResponse) throws {
    let status = (response as! HTTPURLResponse).status

    guard status.responseType == .success else {
        switch status {
        case .unauthorized:
            print("Unauthorized")
        default:
            print("Non-success status: \(status)")
        }
        throw status
    }
}
Swift

GitHub

https://github.com/ralfebert/SweetURLRequest