Skip to content

Latest commit

 

History

History
77 lines (43 loc) · 2.78 KB

README.md

File metadata and controls

77 lines (43 loc) · 2.78 KB

AsyncHTTPNetworkService

AsyncHTTPNetworkService is a Swift native library network layer for using Concurrency (Async/Await).

The goal is to provide a simple network library so you don't have to think about it.

Example use

let networkService = AsyncHTTPNetworkService()
// see below on URLRequestBuilder + URLRequest extension for a easy example creating URL Requests
let urlRequest = URLRequest(...)
let person: Person = try await networkService.requestObject(urlRequest)
// person inherits from Codable

let searchResults: [Results] = try await networkService.requestObjects(urlRequest)

// networkService.requestVoid
// networkService.requestString

Compatibility

AsyncHTTPNetworkService is compatible to iOS 13+. If there are issues surrounding Aync/Await for < iOS 15, please let us know.

URLRequestBuilder + URLRequest extension

AsyncHTTPNetworkService includes URLRequest helpers for ease of creating requests and modifying requests

let baseURL = URLRequestBuilder(baseURL:  URL(string: "someendpoint"))

baseURL.get("user").queryItems(["tag": "check"])
baseURL.post("login").token("accessToken")
baseURL.post("withBody").body(json: codableObject)

Request Modifiers

AsyncNetworkService provides a basic protocol called NetworkRequestModifier that allows you to modify the network request before it sends.

2 options are included in AsyncNetworkService

APIKeyRequestModifier

Use this to pass up an api_key parameter inside a queryItem for all requests. A good example is when you're using a service that requires an api key.

This modifier could easily be updated to add an api_key to the request headers instead

BearerTokenRequestModifier

For each request, this will add in the passed in authenticationToken inside the Authorization header.

Example App

Included in this repo is a SwiftUI example app using AsyncHTTPNetworkService connecting to a Giphy api. Included is showing how using Codable to decode to objects easily.

The network calls to connect to Giphy is layed out in AsyncService.swift

Inside the GiphyService class is a list of Routes that are connected, and a function for each endpoint that is connected.

The init of the GiphyService includes an APIKeyRequestModifier that adds the a api_key to the header on each network request.

Maintainers

Matt Kiazyk

Contact

Made with ❤️ by Robots & Pencils

Twitter | GitHub