Struct ShadowLedger 

pub struct ShadowLedger { /* private fields */ }

Per-(tenant, route) shadow spend for the current UTC day.

Implementations

impl ShadowLedger

pub fn new() -> Self

A fresh ledger.

pub fn may_spend( &self, tenant: &str, route_ix: usize, max_usd_per_day: f64, now: Timestamp, ) -> bool

Whether a shadow evaluation may start, given the day’s ceiling.

Checked before the call rather than after, because the point of a ceiling is to not spend the money — discovering the overrun afterwards defeats it. The trade is that a single evaluation can overshoot by its own cost; with per-call costs in fractions of a cent against a dollar-scale daily cap that is immaterial, and erring toward one extra cheap call is better than erring toward silently skipping measurements.

pub fn debit(&self, tenant: &str, route_ix: usize, usd: f64, now: Timestamp)

Record what a completed shadow evaluation cost.

pub fn spent_today(&self, tenant: &str, route_ix: usize, now: Timestamp) -> f64

Spend so far today, for reporting.

Trait Implementations

impl Debug for ShadowLedger

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

Formats the value using the given formatter.

impl Default for ShadowLedger

fn default() -> ShadowLedger

Returns the “default value” for a type.