DBNetworkStack
| Main Features | |
|---|---|
| |
Typed network resources |
| |
Value oriented architecture |
| |
Exchangeable implementations |
| |
Extendable API |
| |
Composable Features |
| |
Fully unit tested |
| |
Documented here |
The idea behind this project comes from this talk.objc.io article.
Basic Demo
Lets say you want to fetch a html string.
First you have to create a service, by providing a network access. You can use URLSession out of the box or provide your own custom solution by implementing NetworkAccess.
let networkAccess = URLSession(configuration: .default)
let networkService = BasicNetworkService(networkAccess: networkAccess)
Create a resource with a request to fetch your data.
let url = URL(staticString: "https://httpbin.org")
let request = URLRequest(path: "/", baseURL: url, HTTPMethod: .GET)
let resource = Resource(request: request, parse: { String(data: $0, encoding: .utf8) })
Request your resource and handle the result
networkService.request(resource, onCompletion: { htmlText in
print(htmlText)
}, onError: { error in
//Handle errors
})
Load types conforming to Swift-Decodable
struct IPOrigin: Decodable {
let origin: String
}
let url = URL(staticString: "https://www.httpbin.org")
let request = URLRequest(path: "ip", baseURL: url)
let resource = Resource<IPOrigin>(request: request, decoder: JSONDecoder())
networkService.request(resource, onCompletion: { origin in
print(origin)
}, onError: { error in
//Handle errors
})
Accessing HTTPResponse
Request your resource and handle the result & http response. This is similar to just requesting a resulting model.
networkService.request(resource, onCompletionWithResponse: { origin, response in
print(origin, response)
}, onError: { error in
//Handle errors
})
Protocol oriented architecture / Exchangability
The following table shows all the protocols and their default implementations.
| Protocol | Default Implementation |
|---|---|
NetworkAccess |
URLSession |
NetworkService |
BasicNetworkService |
NetworkTask |
URLSessionTask |
Composable Features
| Class | Feature |
|---|---|
RetryNetworkService |
Retrys requests after a given delay when an error meets given criteria. |
ModifyRequestNetworkService |
Modify matching requests. Can be used to add auth tokens or API Keys |
NetworkServiceMock |
Mocks a NetworkService. Can be use during unit tests |
Requirements
- iOS 9.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+
- Xcode 10.2+
- Swift 5.0
Installation
Swift Package Manager
SPM is integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
Specify the following in your Package.swift:
.package(url: "https://github.com/dbsystel/DBNetworkStack", from: "2.0.0"),
Contributing
Feel free to submit a pull request with new features, improvements on tests or documentation and bug fixes. Keep in mind that we welcome code that is well tested and documented.
Contact
Lukas Schmidt (Mail, @lightsprint09), Christian Himmelsbach (Mail)
License
DBNetworkStack is released under the MIT license. See LICENSE for details.
4 Jan 28, 2022
1.9k Dec 30, 2022
37 Jan 29, 2022
14.4k Jan 1, 2023
100 Dec 9, 2022
528 Dec 26, 2022
446 Dec 17, 2022
10 Nov 19, 2022
89 Dec 26, 2022
2 Sep 16, 2022
5 Oct 17, 2022
19 Nov 19, 2022
4 Dec 2, 2022
3 Aug 18, 2022
6 Apr 4, 2020
35 Mar 29, 2019
1 Apr 21, 2022
589 Jun 29, 2022