/hmrc-fx

Primary LanguageSwiftBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

HMRC FX Rate

This package provide currency conversion via UK HMRC rate

Swift

Example

Please reference HMRC's XML for possible values of the "CurrencyCode".

import Foundation
import HMRCExchangeRate

// Get exchange rate by `Date`
let rates = try? await RateSource.directHMRC.rate(of: "TWD", at: Date())
if let rate = rates?.first {
    print("Current rate - \(rate)")
}

// Get exchange rate of a certain month
let rates = try? await RateSource.directHMRC.rate(of: "TWD", in: Month(.sep, in: 2020))
if let rate = rates?.first {
    print("Rate of Sept 2020 - \(rate)")
}

Setup as a dependency

This is a Swift Package, and hence you could use it in a way like this

// swift-tools-version:5.5

import PackageDescription

let package = Package(
    name: "fx-example",
    platforms: [
        .macOS(.v12),
    ],
    dependencies: [
        .package(url: "https://github.com/sodastsai/hmrc-fx.git", from: "0.5.0"),
    ],
    targets: [
        .target(
            name: "fx-example",
            dependencies: [
                .product(name: "HMRCExchangeRate", package: "hmrc-fx"),
            ]
        ),
    ]
)