mRs- / Porygon

A tiny networking library with Combine support

Porygon

Porygon is a networking library heavily inspired by tiny-networking, but designed primarily for use with Combine. It defines an Endpoint type which encapsulates the relationship between a URLRequest and the Decodable entity it represents.

A Simple Example

struct Repository: Decodable {
    let id: Int64
    let name: String
}

func repository(author: String, name: String) -> Endpoint<Repository> {
    return Endpoint(json: .get, url: URL(string: "https://api.github.com/repos/\(author)/\(name)")!)
}

let endpoint = repository(author: "rhysforyou", name: "Porygon")

This simply gives us the description of an endpoint, to actually load it, we need to subscribe to its publisher:

subscriber = URLSesion.shared.endpointPublisher(endpoint)
    .sink(receiveCompletion: { print("Completed: \($0)") },
          receiveValue: { print("Value: \($0)") })

If the subscriber is cancelled or deallocated before it finishes, any networking operations will be halted.