hmrc-rates 0.3.3

HMRC exchange rates (monthly, spot, yearly average, weekly) with bundled history and GBP conversion.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

//! Convert amounts to GBP with bundled rates
//!
//! Run with: cargo run --example convert
#![allow(clippy::unwrap_used)] // examples favour brevity

use hmrc_rates::{RateType, Rates, YearEnd, YearMonth};
use rust_decimal::Decimal;

fn main() -> Result<(), hmrc_rates::LookupError> {
    let rates = Rates::new();

    // The everyday case: an amount on a date, at that month's rate
    let date = chrono::NaiveDate::from_ymd_opt(2025, 8, 15).unwrap();
    let rate = rates.monthly_rate("USD", date)?;
    let gbp = rate.to_gbp(Decimal::from(2500));
    println!("$2500 on {date} = £{} (exact: £{gbp})", gbp.round_dp(2));

    // Many conversions in one month: resolve the table once
    let table = rates.monthly(YearMonth::new(2025, 8).unwrap())?;
    let eur = table.rate("EUR")?;
    let total: Decimal = [1200, 450, 80]
        .into_iter()
        .map(|amount| eur.to_gbp(Decimal::from(amount)))
        .sum();
    println!("three EUR invoices = £{}", total.round_dp(2));

    // Self Assessment style: the yearly average to 31 March
    let avg = rates.average(YearEnd::march(2025))?.rate("EUR")?;
    println!(
        "EUR average for the year to 31 Mar 2025: {}",
        avg.units_per_gbp()
    );

    // What's available?
    let months = rates.months().count();
    let currencies = rates.currencies(RateType::Monthly).count();
    println!("{months} months bundled, {currencies} currencies");
    Ok(())
}