christiankm / superhighway

As big a networking library as you'll need

Superhighway

Swift Package Index listing • Documentation • Compatibility

Superhighway is a networking library heavily inspired by tiny-networking. 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 getRepository(author: String, name: String) -> Endpoint<Repository> {
  return Endpoint(
    decoding: Repository.self,
    method: .get,
    url: URL(string: "https://api.github.com/repos/\(author)/\(name)")!
  )
}

let endpoint = getRepository(author: "rhysforyou", name: "Superhighway")

This simply gives us the description of an endpoint, to actually load it, we can pass it to a URLSession:

do {
    let (repository, _) = try await URLSession.default.response(for: endpoint)
    print("Repository: \(repository)")
} catch {
    print("Error: \(error)")
}

If the task is cancelled before it finishes, any networking operations will be halted.

Installing

The recommended way to use Superhighway is through the Swift Package manager. For Xcode projects, simply add this repository to the project's Swift packages list. For projects using a Package.swift file, add the following:

// swift-tools-version:5.5
import PackageDescription

let package = Package(
    // ...
    dependencies: [
        .package(url: "https://github.com/rhysforyou/Superhighway.git", "0.5.0"..<"0.6.0")
    ],
    targets: [
        .target(
            name: "MyTarget",
            dependencies: ["Superhighway"])
    ]
)

Other package managers such as CocoaPods and Carthage are officially unsupported, but this entire library is encapsulated in a single Endpoint.swift file which can be copied into an existing project and used as-is.