amiibo-service/Sources/Clients/AmiiboClient.swift
Javier Cicchelli 6ba137a482 [Enhancement] Linux platform support (#17)
This PR contains the work done to provide full support of this package to Linux platform, by removing the restriction on the `AmiiboClient` client and the `AmiiboService` service put in place on the `v1.0.1` release.

To provide further details about the work done:
- [x] updated the `SwiftLibs` package dependency to `v0.1.7`;
- [x] made the `AmiiboClient` client and the `AmiiboService` service available to Linux platforms by importing the `FoundationNetworking` framework when available;
- [x] updated the content of some DocC documentation pages;
- [x] regenerated the Xcode and Github pages documentation;
- [x] updated some text in the `README` file.

Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Reviewed-on: #17
2023-04-30 13:59:37 +00:00

103 lines
2.9 KiB
Swift

//===----------------------------------------------------------------------===//
//
// This source file is part of the AmiiboService open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the AmiiboService project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of AmiiboService project authors
//
//===----------------------------------------------------------------------===//
import Communications
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
struct AmiiboClient {
// MARK: Properties
private let session: URLSession
private let decoder = JSONDecoder()
private let makeURLRequest = MakeURLRequestUseCase()
// MARK: Initialisers
init(configuration: URLSessionConfiguration) {
session = .init(configuration: configuration)
}
// MARK: Functions
func setDateDecodingStrategy(_ dateDecodingStrategy: JSONDecoder.DateDecodingStrategy) {
decoder.dateDecodingStrategy = dateDecodingStrategy
}
}
// MARK: - Client
extension AmiiboClient: Client {
// MARK: Functions
func request<Model>(
endpoint: some Endpoint,
as model: Model.Type
) async throws -> Model where Model : Decodable {
let urlRequest = try makeURLRequest(endpoint: endpoint)
let (data, response) = try await data(from: session, for: urlRequest)
try check(response)
return try decoder.decode(model, from: data)
}
}
// MARK: - Helpers
private extension AmiiboClient {
// MARK: Functions
func data(
from session: URLSession,
for urlRequest: URLRequest
) async throws -> (Data, URLResponse) {
#if canImport(FoundationNetworking)
try await withCheckedThrowingContinuation { continuation in
session.dataTask(with: urlRequest) { data, response, error in
if let error {
continuation.resume(with: .failure(error))
} else if let data, let response {
continuation.resume(with: .success((data, response)))
} else {
continuation.resume(with: .failure(AmiiboClientError.dataOrResponseNotFound))
}
}
}
#else
try await session.data(for: urlRequest)
#endif
}
func check(_ response: URLResponse) throws {
guard
let urlResponse = response as? HTTPURLResponse,
let responseCode = HTTPResponseCode(rawValue: urlResponse.statusCode)
else {
throw AmiiboClientError.responseCodeNotFound
}
guard responseCode == .ok else {
throw AmiiboClientError.responseCode(responseCode.rawValue)
}
}
}