A super-lightweight network client library. Heavily inspired by Moya, Alamofire.
What you can do:
- Making synchronous, asynchronous request.
- Making chain synchronous request in background thread.
- Create custom network client.
- Build request separately.
- Intercept, mutate request before execute.
- Handle unauthorized request (Refresh token).
- Basic auth (Oauth).
- Add JSON support.
- Network logger.
To run the example project, clone the repo, and run pod install from the Example directory first.
- iOS 9.3
- Xcode 8.3
- Swift 3.2
NilNetzwerk is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'NilNetzwerk'Execute request
import NilNetzwerk
NilNetzwerk.sharedInstance.get(url: URL(string: "https://httpbin.org/get")!) { (result: Result<SimpleModel>) in
switch result {
case .success(let response):
print(response)
case .failure(let error):
print(error)
}
}
struct SimpleModel: Codable {}You can create a request by implementing "ServiceEndpoint" protocol with any type (enum, struct, class). (enum is recommended)
import NilNetzwerk
// An instance of the request generator which prepares the HTTP request.
struct TestRequestGenerator: RequestGenerator {
func generateRequest(withMethod method: HTTPMethod) -> MutableRequest {
return request(withMethod: method) |> withJsonSupport
}
}
// Endpoints that you want to use.
enum TestFetchEndPoint {
case testPost(name: String, job: String)
}
// Implementing ServiceEndpoint protocol
extension TestFetchEndPoint: ServiceEndpoint {
// An instance of the request generator which prepares the HTTP request.
var requestGenerator: RequestGenerator {
return TestRequestGenerator()
}
// The parameters of the endpoint.
var parameters: Codable? {
switch self {
case .testPost(let name, let job):
return TestPostModel(name: name, job: job)
}
}
// The base url for the endpoint.
var baseURL: URL {
switch self {
case .testPost:
return URL(string: "https://reqres.in/api")!
}
}
// The required method.
var method: HTTPMethod {
switch self {
case .testPost:
return .POST
}
}
// The specific path of the endpoint.
var path: String {
switch self {
case .testPost:
return "/users"
}
}
// The query parameters which are added to the url.
var queryParameters: [String : String]? {
switch self {
case .testPost:
return nil
}
}
// The parameters which are added to the header.
var headerParameters: [String : String]? {
switch self {
case .testPost:
return nil
}
}
}
struct TestPostModel: Codable {
let name: String
let job: String
}You can create custom RequestGenerator by implementing RequestGenerator protocol. (Json support, Basic auth)
struct TestRequestGenerator: RequestGenerator {
func generateRequest(withMethod method: HTTPMethod) -> MutableRequest {
return request(withMethod: method) |> withJsonSupport |> withBasicAuth
}
var authUserName: String? {
return "Auth UserName"
}
var authPassword: String? {
return "Auth Password"
}
}import NilNetzwerk
let testRequest = Request(endpoint: TestFetchEndPoint.testPost(name: "Nil", job: "iOS"))
NilNetzwerk.sharedInstance.executeRequest(request: testRequest) { (result: Result<TestPostModel>) in
switch result {
case .success(let response):
print(response)
case .failure(let error):
print(error)
}
}import NilNetzwerk
let testRequest = Request(endpoint: TestFetchEndPoint.testPost(name: "Nil", job: "iOS"))
let result: Result<TestPostModel> = NilNetzwerk.sharedInstance.executeRequest(request: testRequest)
switch result {
case .success(let response):
print(response)
case .failure(let error):
print(error)
import NilNetzwerk
let testRequest = Request(endpoint: TestFetchEndPoint.testPost(name: "Nil", job: "iOS"))
DispatchQueue.global(qos: .background).async {
let result: Result<TestPostModel> = NilNetzwerk.sharedInstance.executeRequest(request: request)
print("TestNetworkClient: \(result.isSuccess)")
let result2: Result<TestPostModel> = NilNetzwerk.sharedInstance.executeRequest(request: request)
print("TestNetworkClient: \(result.isSuccess) & \(result2.isSuccess)")
}You can use default network client by calling "NilNetzwerk.sharedInstance". However, if you want to create custom network client you can extend "NilNetzwerk" class then implement your own network client.
import NilNetzwerk
class TestNetworkClient: NilNetzwerk {
static let shared = TestNetworkClient()
private let urlSession: URLSession = {
let configuration = URLSessionConfiguration.default
configuration.requestCachePolicy = .reloadIgnoringLocalAndRemoteCacheData
configuration.timeoutIntervalForRequest = 30
configuration.urlCache = nil
return URLSession(configuration: configuration)
}()
override init() {
super.init(urlSession: urlSession)
enableLog = true
}
}Intercept method before execute request.
import NilNetzwerk
class CustomNetworkClient: NilNetzwerk {
// intercept method
override func adapter(request: inout Request) {
}
}Every request that return 401 (unauthorized) will be enqueue to property "requestsToRetry" then this method will be executed.
import NilNetzwerk
class CustomNetworkClient: NilNetzwerk {
// Handle unauthorized method
override func handleUnauthorized(request: Request, completion: @escaping (Bool) -> Result<Error>?) {
// You can implement request, refresh token method here
// This is a queue of unauthorized request, you can dequeue and execute request again.
let allRequestsToRetry = self.requestsToRetry
}
}Nil-Biribiri, [email protected]
NilNetzwerk is available under the MIT license. See the LICENSE file for more info.