Struct PriceDatabase 

pub struct PriceDatabase { /* private fields */ }

Database of currency prices.

Stores prices as a map from base currency to a list of (date, price, quote currency). Prices are kept sorted by date for efficient lookup.

Implementations

impl PriceDatabase

pub fn new() -> Self

Create a new empty price database.

pub fn from_directives(directives: &[Directive]) -> Self

Build a price database from directives.

Extracts prices from:

• Explicit price directives
• Implicit prices from transaction postings (@ price annotations and cost specs)

This matches Python beancount’s behavior when using the implicit_prices plugin.

pub fn sort_prices(&mut self)

Sort all price entries by date.

Call this after adding prices to ensure lookups work correctly.

pub fn add_price(&mut self, price: &PriceDirective)

Add a price directive to the database.

pub fn add_implicit_prices_from_transaction(&mut self, txn: &Transaction)

Add implicit prices from transaction postings.

Extracts prices from:

1. Price annotations (@ price or @@ total_price) - takes priority
2. Cost specifications ({cost}) when no valid price annotation

This matches Python beancount’s implicit_prices plugin behavior.

pub fn get_price( &self, base: &str, quote: &str, date: NaiveDate, ) -> Option<Decimal>

Get the price of a currency on or before a given date.

Returns the most recent price for the base currency in terms of the quote currency. Tries direct lookup, inverse lookup, and chained lookup (A→B→C).

pub fn get_latest_price(&self, base: &str, quote: &str) -> Option<Decimal>

Get the latest price of a currency (most recent date).

Supports direct lookup, inverse lookup, and chained lookup (A→B→C).

pub fn convert( &self, amount: &Amount, to_currency: &str, date: NaiveDate, ) -> Option<Amount>

Convert an amount to a target currency.

Returns the converted amount, or None if no price is available.

pub fn convert_latest( &self, amount: &Amount, to_currency: &str, ) -> Option<Amount>

Convert an amount using the latest available price.

pub fn currencies(&self) -> impl Iterator<Item = &str>

Get all currencies that have prices defined.

pub fn has_prices(&self, currency: &str) -> bool

Check if a currency has any prices defined.

pub fn len(&self) -> usize

Get the number of price entries.

pub fn is_empty(&self) -> bool

Check if the database is empty.

pub fn iter_entries( &self, ) -> impl Iterator<Item = (&str, NaiveDate, Decimal, &str)>

Iterate over all price entries with their base currency.

Returns tuples of (base_currency, date, price, quote_currency).

Trait Implementations

impl Debug for PriceDatabase

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PriceDatabase

fn default() -> PriceDatabase

Returns the “default value” for a type.