Struct TokenBudget 

pub struct TokenBudget { /* private fields */ }

A token budget that tracks spending against a maximum allocation.

Implementations

impl TokenBudget

pub fn new(max_tokens: u64) -> Self

Create a new budget with the given maximum.

pub fn max_tokens(&self) -> u64

Maximum tokens allowed.

pub fn used_tokens(&self) -> u64

Tokens consumed so far.

pub fn spend(&mut self, tokens: u64) -> bool

Spend tokens from the budget. Returns true if the budget was sufficient, false if it would exceed the limit (in which case the spend is still applied to track overruns).

pub fn remaining(&self) -> u64

Remaining tokens before the budget is exhausted.

pub fn is_exhausted(&self) -> bool

Whether the budget is fully consumed.

pub fn can_afford(&self, cost: u64) -> bool

Check if a given cost can be afforded without exceeding the budget.

pub fn utilization(&self) -> f64

Utilization ratio in [0.0, 1.0+] (can exceed 1.0 if overspent).

pub fn reset(&mut self)

Reset the budget to zero usage.

Trait Implementations

impl Clone for TokenBudget

fn clone(&self) -> TokenBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenBudget

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TokenBudget

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TokenBudget

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

where __S: Serializer,

Serialize this value into the given Serde serializer.