Crate lib_frankfurter 

Rust bindings to the Frankfurter API

Usage

use std::str::FromStr;

use lib_frankfurter::{
    api::{convert, currencies, period, ServerClient},
    url::Url,
    ValidDate,
};

#[tokio::main]
async fn main() {
    let server_client: ServerClient = Url::parse("http://localhost:8080")
        .map(ServerClient::new)
        .unwrap_or_default();

    // Fetch supported currencies - this request does not accept any additional options
    match server_client
        .currencies(currencies::Request::default())
        .await
    {
        Ok(resp) => {
            println!("{}", serde_json::to_string_pretty(&resp).unwrap())
        }
        Err(e) => panic!("{e:?}"),
    }

    // Fetch latest exchange rates - for available, options check out [`convert::Request`]
    match server_client.convert(convert::Request::default()).await {
        Ok(resp) => {
            println!("{}", serde_json::to_string_pretty(&resp).unwrap())
        }
        Err(e) => panic!("{e:?}"),
    };

    // Fetch exchange rates from 01/01/2024 to the present date - for available options, check out [`period::Request`]
    match server_client
        .period(period::Request {
            start_date: ValidDate::from_str("2024-01-01").unwrap(),
            ..Default::default()
        })
        .await
    {
        Ok(resp) => {
            println!("{}", serde_json::to_string_pretty(&resp).unwrap());
        }
        Err(e) => panic!("{e:?}"),
    };
}

Re-exports

pub use chrono;

pub use reqwest;

pub use serde_json;

pub use url;

Modules

api

Interface to the Frankfurter API.

Structs

CurrencyValue

Wrapper around an f64, representing a valid currency value/amount.

ValidDate

Wrapper around a [chronos::NaiveDate], representing a valid date to fetch exchange rates for.

Enums

Currency

Possible currency codes (ISO 4217) returned by the Frankfurter API.

Error

Possible errors that can be encountered when making requests using the crate::api::ServerClient.