klirr-core 0.2.1

Zero-maintenance and smart FOSS generating beautiful invoices for services and expenses.
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

use crate::prelude::*;

pub trait FetchExchangeRates {
    fn fetch_for_items(&self, target_currency: Currency, items: Vec<Item>)
    -> Result<ExchangeRates>;

    fn fetch_for_line_items(
        &self,
        target_currency: Currency,
        line_items: &LineItemsPricedInSourceCurrency,
    ) -> Result<ExchangeRates> {
        let Ok(expenses) = line_items.clone().try_unwrap_expenses() else {
            debug!("No expenses found, skipping exchange rate fetching.");
            return Ok(ExchangeRates::builder()
                .target_currency(target_currency)
                .rates(ExchangeRatesMap::new())
                .build());
        };
        debug!("☑️ Fetching rates for #{} expenses...", expenses.len());
        self.fetch_for_items(target_currency, expenses)
    }
}

pub fn prepare_invoice_input_data<Period: IsPeriod>(
    data: Data<Period>,
    input: ValidInput,
    fetcher: impl FetchExchangeRates,
) -> Result<PreparedData> {
    info!("Preparing invoice input data for PDF generation...");
    let partial = data.to_partial(input)?;
    let currency = *partial.payment_info().currency();
    let exchange_rates = fetcher.fetch_for_line_items(currency, partial.line_items())?;
    let data_typst_compat = partial.to_typst(exchange_rates)?;
    info!("✅ Prepared invoice input data for PDF generation.");
    Ok(data_typst_compat)
}