Ape
Ape is a tiny library I’ve being using to simplify some REST API tasks. Think of it as solving some of the problems Alamofire does, but it’s under 100 lines of code so you can wrap your head around the whole thing. 🙈🙊🙉
Example Usage
Basic
import Ape
import Foundation // for NSURL
let url = NSURL(string: "http://google.com")!
_ = Ape(method: .Get, url: url, body: .None) {
resp in
print("got a response")
}
print("sending")
sleep(10) // wait for async operation to complete (assuming you're running this on command line.
Methods
Ape supports Get, Post, Put and Delete.
Bodies
Ape's Body enum can contain JSON objects, NSData, or nothing.
Supply a JSON body:
let json = ["name": "world", "count": 10]
_ = Ape(method: .Get, url: url, body: .JSON(json)) { resp in }
Supply an NSData body:
let data = "Please feed me tacos".dataUsingEncoding(NSUTF8StringEncoding)
_ = Ape(method: .Get, url: url, body: .Data(data)) { resp in }
Responses
Ape's APIResponse struct has three public properties:
public let body: Body
public let urlResponse: NSHTTPURLResponse?
public let error: ErrorType?
body
is just like the body when you're sending a request, either .None
, .JSON
or .Data
. To unpack it, you can use the usual switch statement:
switch resp.body {
case .JSON(let json):
break
case .Data(let data):
break
case .None:
break
}
You can also use conditional pattern matching to check for a single case:
if case .JSON(let json) = resp.body { // also works in a gaurd statement
print("json is \(json)")
}
init methods
Ape has two init methods:
init(method: Method = .Get, request: NSURLRequest, body: Body = .None, completion: ResponseClosure)
init(method: Method = .Get, url: NSURL, auth: AuthClosure = { _ in }, body: Body = .None, completion: ResponseClosure)
As you can see, most of the parameters have default values, so you can omit them if you are ok with the defaults.
Ape(request: request) {
resp in
// ...
}
or
Ape(url: request) {
resp in
// ...
}
AuthClosure is a typealias of the closure type (NSMutableURLRequest)->(Void)
, a closure that takes in a mutable url request and modifies it to contain auth data (set http headers, etc).
Installation
Swift Package Manager
Add Later to your Package.swift
file:
import PackageDescription
let package = Package(
name: "YourPackageName",
dependencies: [
.Package(url: "https://github.com/coryalder/Ape.git", majorVersion: 0),
]
)