Struct GeneralPriceIndex 

pub struct GeneralPriceIndex {
    pub currency: String,
    pub source: String,
    pub observations: Vec<(NaiveDate, Decimal)>,
}

Time series of general-price-index (CPI) observations for a hyperinflationary economy. The index is monotonically non-decreasing in normal use; the lookup helpers tolerate out-of-order dates by sorting on access.

Fields

currency: String

ISO 4217 currency code the index applies to (e.g. “ARS”, “TRY”). Joins to entity functional currency for lookup.

source: String

Source / methodology label (e.g. “INDEC IPC General”, “TÜİK CPI”). Carried for audit-trail purposes.

observations: Vec<(NaiveDate, Decimal)>

Observed (date, index level) pairs. Index level convention: any positive Decimal — the helpers compute relative indexation factors (new / old), so absolute scale is free.

Implementations

impl GeneralPriceIndex

pub fn new(currency: impl Into<String>, source: impl Into<String>) -> Self

Construct an empty index for currency from a labelled source.

pub fn observe(&mut self, date: NaiveDate, level: Decimal) -> &mut Self

Append an observation. Caller is responsible for ordering; Self::lookup sorts on access.

pub fn lookup(&self, date: NaiveDate) -> Option<Decimal>

Look up the index level for a date. Returns the level on the most recent observation at or before date, mirroring the conservative IAS 29 convention of using the latest available CPI for each measurement date. Returns None when no observation exists at or before the date.

pub fn indexation_factor( &self, from_date: NaiveDate, to_date: NaiveDate, ) -> Option<Decimal>

Compute the IAS 29 § 12 indexation factor for restating a historical-cost amount from from_date to to_date:

factor = index(to_date) / index(from_date)

Returns None when either lookup misses, or when the from_date index is zero (would otherwise divide-by-zero).

Trait Implementations

impl Clone for GeneralPriceIndex

fn clone(&self) -> GeneralPriceIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeneralPriceIndex

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GeneralPriceIndex

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for GeneralPriceIndex

fn eq(&self, other: &GeneralPriceIndex) -> 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 Serialize for GeneralPriceIndex

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GeneralPriceIndex