HottPotato

Delicious HTTP requests

I got tired of writing networking code over and over again for side projects, so I made something I could quickly toss in.

Features

• Simple HTTP requests
• Automatic parsing of Decodable models

Getting Started

• Download HottPotato and do a pod install on the included HottPotatoDemo app to see it in action
• Check out the documentation for a more comprehensive look at the classes available in HottPotata

Swift Version

Currently compatible with Swift 5.0.

Installation with CocoaPods

pod 'HottPotato', :git => 'https://github.com/hkellaway/HottPotato.git', :tag => '0.1.0'

Installation with Carthage

github "hkellaway/HottPotato"

Installation with Swift Package Manager

import PackageDescription
let package = Package(
    name: "HelloWorld",
    dependencies: [
        .Package(url: "https://github.com/hkellaway/HottPotato.git", majorVersion: 0, minor: 1)
    ]
)

Usage

Retrieving Models

To make a request, create an HTTPResource with a type that is Decodable and enjoy receiving the Result.

let httpClient = HottPotato.shared
let resource = HTTPResource<GitHubProfile>(
    method: .GET,
    baseURL: "https://api.github.com",
    path: "/users/hkellaway"
)
httpClient.sendRequest(for: resource) { result in
    switch result {
        case .success(let profile):
            print("Hello world from \(profile.login)")
        case .failure(let error):
            print("Goodbye world: \(error.localizedDescription)")
    }
}

Discussion

HottPotato simply wraps URLSession and leverages some preferred context and patterns. Namely, it assumes we’re making HTTP requests, we’re receiving JSON back, and our requested models conform toDecodable. Additionally, it uses the Result type in its response.

Why? Because this is a typical setup for applications & libraries I’ve worked on. Plus, I’m a big fan of the Result type.

Retrieving JSON

Internally, HottPotato retrieves JSON - if you’d rather use it to retrieve JSON, simply:

guard let request = resource.toHTTPRequest() else {
    return
}
httpClient.sendJSONRequest(with: request, success: { (_, json) in
    print(json)
}, failure: { error in
    print(error)
})

Retrieving Raw Data and HTTPURLResponse

At its very heart, HottPotato simply makes a URLRequest using URLSession and returns the retrieved Data and HTTPURLResponse. If you’d rather use it to get back the raw response, simply:

httpClient.sendHTTPRequest(with: request, success: { (_, response) in
    print(response.statusCode)
}, failure: { error in
    print(error)
})

Credits

HottPotato was created by Harlan Kellaway.

License

HottPotato is available under the MIT license. See the LICENSE file for more info.