delopay 0.2.1

Official Rust SDK for the DeloPay payments API
Documentation
//! The `forex` resource: exchange rates and currency conversion. Open
//! response shapes — see the API reference.

use std::sync::Arc;

use serde_json::Value;

use crate::core::error::Result;
use crate::http::client::Inner;
use crate::http::transport::HttpMethod;

/// The `forex` resource, obtained via [`crate::Delopay::forex`].
#[derive(Debug, Clone)]
pub struct Forex {
    inner: Arc<Inner>,
}

impl Forex {
    pub(crate) fn new(inner: Arc<Inner>) -> Self {
        Self { inner }
    }

    /// Retrieve current forex rates. Query keys are open — pass `&[]` for
    /// none; see the API reference for the accepted filters.
    pub async fn rates(&self, query: &[(&str, String)]) -> Result<Value> {
        self.inner
            .request(HttpMethod::Get, "/forex/rates", None, query, None)
            .await
    }

    /// Convert an amount from minor currency units. Query keys are open —
    /// see the API reference.
    pub async fn convert_from_minor(&self, query: &[(&str, String)]) -> Result<Value> {
        self.inner
            .request(
                HttpMethod::Get,
                "/forex/convert-from-minor",
                None,
                query,
                None,
            )
            .await
    }
}

#[cfg(test)]
mod tests {
    use crate::http::mock::{Step, client_with};

    #[tokio::test]
    async fn forex_endpoints_hit_their_paths_with_queries() {
        let (client, mock) = client_with(vec![
            Step::ok(r#"{"rates":{}}"#),
            Step::ok(r#"{"amount":10.0}"#),
        ]);
        client.forex().rates(&[]).await.unwrap();
        client
            .forex()
            .convert_from_minor(&[
                ("amount", "1000".to_string()),
                ("to_currency", "USD".to_string()),
            ])
            .await
            .unwrap();

        let seen = mock.seen.lock().unwrap();
        assert_eq!(
            (seen[0].method, seen[0].url.as_str()),
            ("GET", "https://api.test/forex/rates")
        );
        assert_eq!(
            (seen[1].method, seen[1].url.as_str()),
            (
                "GET",
                "https://api.test/forex/convert-from-minor?amount=1000&to_currency=USD"
            )
        );
    }
}