javier
2b01ec14bf
This PR contains the work done to update the live tests to the latest data plus lots of QoL improvements to the library, including: * added test cases to test the ``AmiiboService` locally; * conformed the models to the `Hashable` protocol; * documented the use of caching with the `AmiiboService` service; * updated the reference to the new AmiiboAPI url; * updated the year on the copyrights and header files; * updated the overall documentation of the source code and the package. Reviewed-on: #22 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
49 lines
1.6 KiB
Swift
49 lines
1.6 KiB
Swift
// ===----------------------------------------------------------------------===
|
|
//
|
|
// This source file is part of the Amiibo Service open source project
|
|
//
|
|
// Copyright (c) 2026 Röck+Cöde VoF. and the Amiibo Service project authors
|
|
// Licensed under Apache license v2.0
|
|
//
|
|
// See LICENSE for license information
|
|
// See CONTRIBUTORS for the list of Amiibo Service project authors
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
//
|
|
// ===----------------------------------------------------------------------===
|
|
|
|
import Foundation
|
|
import OpenAPIRuntime
|
|
|
|
/// A type that allows the decoding and encoding of ISO timestamp dates, defined by the `yyyy-MM-dd'T'HH:mm:ss.SSSSSS` custom date format.
|
|
struct ISOTimestampTranscoder {
|
|
|
|
// MARK: Properties
|
|
|
|
/// A formatter to use to decode and encode ISO timestamps dates.
|
|
private let dateFormatter: DateFormatter = .isoTimestamp
|
|
|
|
}
|
|
|
|
// MARK: - DateTranscoder
|
|
|
|
extension ISOTimestampTranscoder: DateTranscoder {
|
|
|
|
// MARK: Functions
|
|
|
|
/// Encodes a date into an ISO timestamp string.
|
|
/// - Parameter date: A date to encode.
|
|
/// - Returns: A string representation of the date in `yyyy-MM-dd'T'HH:mm:ss.SSSSSS` format.
|
|
func encode(_ date: Date) throws -> String {
|
|
dateFormatter.string(from: date)
|
|
}
|
|
|
|
/// Decodes an ISO timestamp string into a date.
|
|
/// - Parameter string: A string to decode.
|
|
/// - Returns: A date parsed from the string, or the Unix epoch if the string cannot be parsed.
|
|
func decode(_ string: String) throws -> Date {
|
|
dateFormatter.date(from: string) ?? .init()
|
|
}
|
|
|
|
}
|