NetworkService
Reactive wrapper for URLSession using Combine. At its core, the library consist of the NetworkServiceClient
protocol along with a minimal implementation NetworkService
.
CustomCodable
A notable convenience the library provides is the CustomCodable
protocol that enables easy encoding and decoding of conforming types. The protocol associates a TopLevelEncoder
and TopLevelDecoder
with a given type so that it is used by the library without explicitly passing it as a parameter. Additionally, CustomEncodable
and CustomDecodable
are included.
Basic Usage
import NetworkService
let networkService = NetworkService()
let url = URL(string: "http://www.foobar.com")!
struct Foo: CustomCodable {
static var encoder: JSONEncoder { JSONEncoder() }
static var decoder: JSONDecoder { JSONDecoder() }
let bar: Int
}
let foo = Foo(bar: 0)
GET
let publisher: AnyPublisher
= networkService.
get(url)
let cancellable
= publisher.
assertNoFailure().
sink { foo
in
print(foo.
bar)
}
POST
let publisher: AnyPublisher
= networkService.
post(foo,
to: url)
let cancellable
= publisher.
assertNoFailure().
sink { foo
in
print(foo.
bar)
}
PUT
let publisher: AnyPublisher
= networkService.
put(foo,
to: url)
let cancellable
= publisher.
assertNoFailure().
sink { foo
in
print(foo.
bar)
}
DELETE
let publisher: AnyPublisher
= networkService.
get(url)
let cancellable
= publisher.
assertNoFailure().
sink {
_
in }
Start
var request = URLRequest(url: url)
request.method = .GET
let publisher: AnyPublisher
= networkService.
start(request)
let cancellable
= publisher.
assertNoFailure().
sink { foo
in
print(foo.
bar)
}
NetworkServiceTestHelper
Provides MockNetworkService
which is an implementation of NetworkServiceClient
for testing. Supports defining set output values for all network functions, repeating values, and delaying responses.
Installation
Currently, only Swift Package Manager is supported.