nissaba/eazyrestclient

- Protocol-based requests with `EazyRestRequest`

Features

Protocol-based requests with EazyRestRequest
Codable support for automatic encoding/decoding
Default headers (Accept & Content-Type)
Optional authorization token
Query parameters and body data support
URLSession under the hood
Callback and Swift Concurrency (async/await) APIs

Installation

Add to your Package.swift:

.package(url: "https://github.com/nissaba/EazyRestClient.git", from: "1.1.0")

Usage

1. Initialize the Client

import EazyRestClient

let client = EazyRestClient(baseURL: "https://api.example.com/")
// Optional authorization
client.authToken = "Bearer <token>"

2. Define a Request

struct MyRequest: EazyRestRequest {
    typealias Response = MyResponseModel

    var httpMethod: HTTPMethods { .get }
    var resourceName: String { "endpoint" }
    // Optionally override queryItems or bodyData
}

Response must conform to Decodable and Sendable (Swift 6 strict concurrency).

3. Callback-based Response Handling

client.send(MyRequest()) { result in
    switch result {
    case .success(let response):
        print(response)
    case .failure(let error):
        print("Error: \(error.localizedDescription)")
    }
}

Or Async/Await Response Handling

// Requires iOS 15.0+, macOS 12.0+, tvOS 15.0+, watchOS 8.0+, visionOS 1.0+
Task {
    do {
        let response = try await client.send(MyRequest())
        print(response)
    } catch {
        print("Error: \(error.localizedDescription)")
    }
}

Custom and Default Headers

By default, all requests include these HTTP headers:

Accept: application/json
Content-Type: application/json

Override in a specific request if needed:

public extension MyCustomRequest: EazyRestRequest {
    var headers: [String: String]? {
        [
            "Accept": "application/json",
            "Authorization": "Bearer \(token)"
        ]
    }
}

Example App

An ExampleApp demonstrating both callback and async/await usage is located in the Examples/ folder. Open ExampleApp.xcodeproj and run on your device or simulator.

License

Package Metadata

Repository: nissaba/eazyrestclient

Default branch: main

README: README.md