Struct PriceAnnotationData 

pub struct PriceAnnotationData {
    pub is_total: bool,
    pub amount: Option<AmountData>,
    pub number: Option<String>,
    pub currency: Option<String>,
}

Price annotation data.

Represents price annotations like @ 100 USD or @@ 1000 USD (total price).

Type-safe consumption (recommended)

Use PriceAnnotationData::view to get a PriceAnnotationView — a typed enum that forces consumers to handle Unit and Total arms exhaustively at compile time. All new code that needs to distinguish per-unit from total prices MUST use view() rather than reading is_total directly.

This struct is the wire format (kept for serialization stability across the WASM plugin boundary). The view() enum is a shaped accessor on top.

Pre-refactor (issue #992), the implicit_prices plugin read posting.price.amount directly and silently ignored is_total, emitting @@ total amounts as per-unit prices. The fix in #997 added explicit handling, but the type system didn’t catch the bug originally because nothing forced consumers to read the bool. The view() enum closes that loop: a missing match arm is a compile error.

Fields

is_total: bool

Whether this is a total price (@@) vs per-unit (@).

Prefer PriceAnnotationData::view for new code — reading this field directly is the bug shape that produced #992 (consumer ignores the field and treats every annotation as per-unit). The view() enum forces exhaustive handling at compile time.

amount: Option<AmountData>

The price amount (optional for incomplete/empty prices).

number: Option<String>

The number only (for incomplete prices).

currency: Option<String>

The currency only (for incomplete prices).

Implementations

impl PriceAnnotationData

pub fn view(&self) -> PriceAnnotationView<'_>

Get a typed view that distinguishes per-unit from total at the type level. Use this for new code that needs to handle the price differently based on @ vs @@.

Returns one of four variants — a missing match arm at the consumer becomes a compile error, eliminating the class of bug that produced issue #992.

Trait Implementations

impl Clone for PriceAnnotationData

fn clone(&self) -> PriceAnnotationData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PriceAnnotationData

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PriceAnnotationData

fn deserialize<__D>( __deserializer: __D, ) -> Result<PriceAnnotationData, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PriceAnnotationData

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.