NetKit

A Concise HTTP Framework in Swift.

Requirements

NetKit requires Swift 5.0 and Xcode 10.2

Installation

CocoaPods

You can use CocoaPods to integrate NetKit with your project.

Simply add the following line to your Podfile:

pod"NetKit"

And run pod update in your project directory.

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate NetKit into your Xcode project using Carthage, specify it in your Cartfile:

github "azizuysal/NetKit"

Run carthage update to build the framework and drag the built NetKit.framework into your Xcode project.

Manually

You can integrate NetKit manually into your project simply by dragging NetKit.framework onto Linked Frameworks and Libraries section in Xcode.

Usage

In order to run the included example project, you can install JSON Server. It provides a quick backend for prototyping and mocking on your local machine. A sample db.json file is included in the example project.

Use WebService to create a client for a particular web service and use it to make requests and process responses.

import NetKit
letservice=WebService(urlString:"http://localhost:3000/")
service.GET("/posts").responseJSON{ json inprint(json)return.Success
}.responseError{ error inprint(error)}.resume()

responseJSON() is a convenience method and combines obtaining a response and converting to JSON into one step. You can also use response() method to obtain raw response data.

.response { data, response inprint(String(data: data!, encoding: NSUTF8StringEncoding))return.Success
}

You can return .Success or .Failure(ErrorType) from the response handlers to signal error status and control will transfer to .responseError() in case of an error.

Synchronous Requests

You can use resumeAndWait() in order to make a synchronous request.

service.PUT("/posts").setPath(String(post.id)).setJSON(post.toJson()).responseJSON{ json inprint(json)return.Success
}.responseError{ error inprint(error)}.resumeAndWait()

Authentication and SOAP support

If you need to set additional parameters, headers or authentication handlers, you can do so with Swift method chaining.

weatherService.POST().authenticate{(method, completionHandler)->WebTaskResultinswitch method {case.Default,.HTTPBasic:completionHandler(.UseCredential,NSURLCredential(user: loginId, password: password, persistence:.ForSession))default:completionHandler(.PerformDefaultHandling,nil)}return.Success
}.setURLParameters(["op":"GetCitiesByCountry"]).setSOAP("<GetCitiesByCountry xmlns=\"http://www.webserviceX.NET\"><CountryName>\(country)</CountryName></GetCitiesByCountry>").response{ data, response inprint(String(data: data!, encoding: NSUTF8StringEncoding))return.Success
}.responseError{ error inprint(error)}.resume()

Support For All Configurations and Task Types

You can easily create WebService instances based on ephemeral or background sessions (the default is based on .defaultSessionConfiguration()).

letservice=WebService(urlString: baseURL, configuration:.ephemeralSessionConfiguration())

Just as easily, you can create upload or download tasks (the default is data task).

lettask= webService.GET("resource", taskType:WebTask.TaskType.Download)

Background Downloads

You can easily setup a background url session and create file download tasks.

letwebService:WebService={letconfiguration=NSURLSessionConfiguration.backgroundSessionConfigurationWithIdentifier("com.azizuysal.netkit.test")
configuration.requestCachePolicy =.ReloadIgnoringLocalAndRemoteCacheData
letservice=WebService(urlString: baseURL, configuration: configuration)return service
}()

You can use the convenient file download handler responseFile() to process downloaded files.

downloadService.getFile().responseFile {(url, response) in
letpath=NSFileManager.defaultManager().URLsForDirectory(.DocumentDirectory, inDomains:.UserDomainMask).first?
if let url = url, response = response, filename = response.suggestedFilename, path = path?.URLByAppendingPathComponent(filename){do{tryNSFileManager.defaultManager().copyItemAtURL(url, toURL: path)}catchlet error as NSError{print(error.localizedDescription)return.Failure(error)}} else {return.Failure(WebServiceError.BadData("Bad params"))}
notifyUser(DownloadService.FileDownloaded, filename: response?.suggestedFilename)return.Success
}.responseError{ error inprint((error asNSError).localizedDescription)notifyUser(DownloadService.FileDownloaded, error: error)}.resumeAndWait()

##License

The MIT License (MIT)