Enum BookingError 

pub enum BookingError {
    AmbiguousMatch {
        num_matches: usize,
        currency: InternedStr,
    },
    NoMatchingLot {
        currency: InternedStr,
        cost_spec: CostSpec,
    },
    InsufficientUnits {
        currency: InternedStr,
        requested: Decimal,
        available: Decimal,
    },
    CurrencyMismatch {
        expected: InternedStr,
        got: InternedStr,
    },
}

Error that can occur during booking.

Variants

AmbiguousMatch

Multiple lots match but booking method requires unambiguous match.

Fields

num_matches: usize

Number of lots that matched.

currency: InternedStr

The currency being reduced.

NoMatchingLot

No lots match the cost specification.

Fields

currency: InternedStr

The currency being reduced.

cost_spec: CostSpec

The cost spec that didn’t match.

InsufficientUnits

Not enough units in matching lots.

Fields

currency: InternedStr

The currency being reduced.

requested: Decimal

Units requested.

available: Decimal

Units available.

CurrencyMismatch

Currency mismatch between reduction and inventory.

Fields

expected: InternedStr

Expected currency.

got: InternedStr

Got currency.

Implementations

impl BookingError

pub const fn with_account(self, account: InternedStr) -> AccountedBookingError

Wrap this booking error with the account context that produced it.

Inventory itself doesn’t know which account it belongs to, so the raw BookingError carries no account field. The caller (booking engine, validator) knows the account and uses this constructor to produce the user-facing error.

The resulting AccountedBookingError is the single canonical rendering of an inventory failure for user-facing output. Both the booking layer and the validator format errors via this type so the wording cannot drift between them — the failure mode that produced #748.

Trait Implementations

impl Clone for BookingError

fn clone(&self) -> BookingError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BookingError

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

Formats the value using the given formatter.

impl Display for BookingError

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

Formats the value using the given formatter.

impl Error for BookingError

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 PartialEq for BookingError

fn eq(&self, other: &BookingError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for BookingError

impl StructuralPartialEq for BookingError