Struct TokenBudgetAspect 

pub struct TokenBudgetAspect { /* private fields */ }

Token-budget aspect.

The host system calls set_budget(session, max) once and bind(charge) before each guarded invocation. The around advice debits the budget if the call would still fit; otherwise it short-circuits with an error.

Implementations

impl TokenBudgetAspect

pub fn new() -> Self

Create an empty budget tracker.

pub fn set_budget(&self, session: impl Into<SessionId>, cap: u64)

Set or reset the budget cap for a session.

pub fn remaining(&self, session: &str) -> Option<u64>

Read remaining tokens for a session. Returns None if no budget has been declared.

pub fn bind(&self, charge: TokenCharge) -> u64

Bind a charge to the next guarded invocation.

pub fn release(&self, key: u64)

Clear a previously bound charge. Idempotent.

Trait Implementations

impl Aspect for TokenBudgetAspect

fn around( &self, pjp: ProceedingJoinPoint<'_>, ) -> Result<Box<dyn Any>, AspectError>

Advice that wraps the entire target function execution.

fn before(&self, _ctx: &JoinPoint)

Advice executed before the target function runs.

fn after(&self, _ctx: &JoinPoint, _result: &(dyn Any + 'static))

Advice executed after the target function completes successfully.

fn after_error(&self, _ctx: &JoinPoint, _error: &AspectError)

Advice executed when the target function encounters an error.

impl Clone for TokenBudgetAspect

fn clone(&self) -> TokenBudgetAspect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for TokenBudgetAspect

fn default() -> TokenBudgetAspect

Returns the “default value” for a type.