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.

Two passes:

1. Explicit Price directives — added unconditionally.
2. Implicit prices from transaction postings — added only for (base, quote, date) tuples that don’t already have an explicit Price entry from pass 1.

The two-pass design fixes issue #1006: when the user enables the implicit_prices plugin, it emits Price directives for each priced posting; pass 1 picks those up. Pre-fix, pass 2 would then ALSO walk the same transactions and re-emit the same implicit prices, doubling every entry. Now pass 2 sees the explicit entry already exists and skips, so the plugin’s output is the single source of truth.

When the plugin is NOT enabled (the rustledger-extension case from #567 / #593 — VALUE() should work on implicit-priced transactions automatically), pass 1 adds nothing for those dates and pass 2 fills them in. Net effect: implicit prices are reachable from BQL without requiring the user to wire up a plugin, but never doubled when the plugin IS wired up.

Behavior note: an explicit Price directive suppresses any divergent transaction-derived implicit price on the same (base, quote, date). This is intentional — explicit Price is authoritative — but a behavior change vs pre-#1015, where a user-written 2024-01-15 price ABC 1.40 EUR plus a transaction emitting ABC@EUR with a different value on the same date would have stored both. Now only the explicit value survives. In practice this only surfaces with hand-authored conflicts.

Provenance tagging (issue #1048): each entry stores explicit: bool. Pass-1 entries are true, pass-2 transaction-derived entries are false. The #prices BQL table filters to explicit: true via iter_explicit_entries to match bean-query, which only surfaces real Price directives. Internal get_price / convert lookups see both kinds — that’s how VALUE() keeps working without the implicit_prices plugin being declared.

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.

Marks the entry as explicit: true — these entries surface in the #prices BQL table.

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_explicit_entries( &self, ) -> impl Iterator<Item = (&str, NaiveDate, Decimal, &str)>

Iterate over explicit price entries only — those sourced from Price directives (either user-written or plugin-emitted). Excludes transaction-derived entries added by the executor’s pass-2 fallback. Used by the #prices BQL table to match bean-query’s behavior.

For internal price lookups (e.g. VALUE(), getprice()), use get_price / convert / convert_latest — those walk the underlying entries without filtering, which preserves the rustledger UX extension where implicit prices are usable for conversion without declaring the implicit_prices plugin.

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.