CatalystNet

Installation:

CocoaPods

pod 'CatalystNet', '~> 1.1.0'

Swift Package Manager

dependencies: [
 .package(url: "https://github.com/hellc/CatalystNet.git", .upToNextMajor(from: "1.1.0"))
]

Manually

Usage:

Http client:

Import package

import CatalystNet

Defining model:

struct Photo: Decodable {
 let albumId: Int
 let id: Int
 let title: String?
 let url: String?
 let thumbnailUrl: String?
}
struct CustomError: Decodable {
 let message: String?
 let code: Int?
}

Defining base Api class:

class ExampleApi: Api {
 private let client: HttpClient!
 
 init(baseUrl: String = "https://jsonplaceholder.typicode.com") {
 self.client = HttpClient(baseUrl: baseUrl)
 }
 
 func load<T, E>(_ resource: Resource<T, E>,
 multitasking: Bool = false,
 completion: @escaping (Result<T, E>) -> Void) {
 // Setup auth policy if needed
 // Also you could extend "Resource" model with authentication method for simply calling "resource.authenticate()" when needed
 super.load(resource, self.client, multitasking: multitasking, completion: completion)
 }
}

Defining Asynchronous Functions (iOS >= 13.0.0)

@available(iOS 13.0.0, *)
@available(macOS 10.15.0, *)
extension ExampleApi {
 func load<T, E>(_ resource: Resource<T, E>) async throws -> T {
 // Setup auth policy here if needed
 return try await super.load(resource, self.client)
 }
}

Defining Api class methods:

class PhotosApi: ExampleApi {
 private struct Endpoints {
 static let photos: String = "/photos"
 }
 func photo(with id: Int, completion: @escaping (Photo?, CatalystError<CustomError>?) -> Void) {
 var resource = Resource<Photo, CustomError>(path: Api.resource(Endpoints.photos, with: id))
 
 resource.method = .get
 
 // resource.authenticate() // if needed
 
 self.load(resource) { response in
 switch response {
 case .success(let photo):
 completion(photo, nil)
 case .failure(let error):
 completion(nil, error)
 }
 }
 }
}

Defining Asynchronous Functions (iOS >= 13.0.0)

@available(iOS 13.0.0, *)
@available(macOS 10.15.0, *)
extension PhotosApi {
 func photo(with id: Int) async throws -> Photo {
 var resource = Resource<Photo, CustomError>(path: Api.resource(Endpoints.photos, with: id))
 
 resource.method = .get
 
 // resource.authenticate() // if needed
 
 return try await self.load(resource)
 }
}

Try it:

let photosApi = PhotosApi()
let photoId: Int = 42
self.photosApi.photo(with: photoId) { (photo, error) in
 print(photo)
}

Try it asynchronously:

let photoId: Int = 42
do {
 let photo = try await self.photosApi.photo(with: photoId)
 print(photo)
} catch {
 print(error)
 // TODO: Proceed "error" object
}

Photo(
 albumId: 1,
 id: 42,
 title: Optional("voluptatibus a autem molestias voluptas architecto culpa"),
 url: Optional("https://via.placeholder.com/600/ca50ac"),
 thumbnailUrl: Optional("https://via.placeholder.com/150/ca50ac")
)