Enum InterpolationError 

pub enum InterpolationError {
    MultipleMissing {
        currency: Currency,
        count: usize,
    },
    NegativeInferredCost {
        currency: Currency,
        per_unit: Decimal,
    },
    AmbiguousInferredCostCurrency {
        candidates: String,
    },
    CannotInferCurrency {
        account: Account,
    },
    DoesNotBalance {
        currency: Currency,
        residual: Decimal,
    },
}

Errors that can occur during interpolation.

Variants

MultipleMissing

Multiple unknowns in the same currency group, where an unknown is either a posting with a missing amount or a posting with an empty cost spec ({}) whose cost-basis weight is deferred to booking- time lot matching. Bean-check enforces “at most one unknown per currency group” — see issue #1026 for the cost-spec extension.

The variant name MultipleMissing is kept for API stability; “missing amounts” in the error message is a slight overgeneral (the count includes cost-unknowns, not just missing amounts), but the field semantics are correct.

Fields

currency: Currency

The currency group with too many unknowns.

count: usize

Total count of unknowns: missing-amount postings plus empty-cost-spec postings whose weight is deferred to booking-time lot matching.

NegativeInferredCost

The residual-solved cost for an empty {} augmentation came out negative — beancount rejects this (“Cost is negative”) rather than booking a negative-cost lot (#1705 edge e14).

Fields

currency: Currency

The cost currency the negative value was solved in.

per_unit: Decimal

The (negative) solved per-unit value.

AmbiguousInferredCostCurrency

An empty {} cost spec names no currency and the transaction’s other postings span more than one currency, so the cost currency (and therefore the residual to solve from) is ambiguous — beancount rejects this (“Failed to categorize posting”) (#1705 edge e15).

Fields

candidates: String

Comma-joined candidate currencies observed.

CannotInferCurrency

Cannot infer currency for a posting.

Fields

account: Account

The account of the posting.

DoesNotBalance

Transaction does not balance after interpolation.

Fields

currency: Currency

The unbalanced currency.

residual: Decimal

The residual amount.

Trait Implementations

impl Clone for InterpolationError

fn clone(&self) -> InterpolationError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InterpolationError

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

Formats the value using the given formatter.

impl Display for InterpolationError

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

Formats the value using the given formatter.

impl Error for InterpolationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<InterpolationError> for BookingError

fn from(source: InterpolationError) -> Self

Converts to this type from the input type.