Struct CurrencyAccountsPlugin 

pub struct CurrencyAccountsPlugin { /* private fields */ }

Plugin that auto-generates currency trading account postings.

Implements the currency trading accounts method as in Python beancount’s beancount.plugins.currency_accounts. For transactions that mix multiple currencies and use price annotations, this plugin:

1. Groups postings by cost.currency (if the posting has a cost) or units.currency (otherwise). Price currency is never used as the group key — this matches Python’s group_postings_by_weight_currency.
2. If there is at least one price annotation in the transaction and there are two or more distinct group keys, inserts a neutralizing posting for each group. The neutralizing posting goes to <base>:<group_key> and carries the negated weight inventory of that group (denominated in the weight/cost currency, which may differ from the group key).
3. Unlike Python’s plugin, does NOT strip price annotations from the original postings. Python strips them because its pipeline runs plugins before booking; rustledger runs booking first, so stripping prices would cause balance-check failures (E3001) in the post-plugin validator.
4. Emits open directives at the earliest transaction date for all newly created currency trading accounts.

Implementations

impl CurrencyAccountsPlugin

pub fn new() -> Self

Create with default base account.

pub const fn with_base_account(base_account: String) -> Self

Create with custom base account.

Trait Implementations

impl Default for CurrencyAccountsPlugin

fn default() -> Self

Returns the “default value” for a type.

impl NativePlugin for CurrencyAccountsPlugin

fn name(&self) -> &'static str

Plugin name.

fn description(&self) -> &'static str

Plugin description.

fn process(&self, input: PluginInput) -> PluginOutput

Process directives and return modified directives + errors.

fn is_synth(&self) -> bool

Whether this plugin synthesizes directives the loader’s Phase::Early validation depends on (e.g. injecting Open directives so account-presence checks see them).