Struct Budget 

pub struct Budget { /* private fields */ }

Shared between an engine’s runtime and its interrupt handler.

Records why execution was interrupted rather than leaving it to be inferred from the engine’s own exception or trap text. QuickJS, for instance, reports an interrupt as an ordinary Error whose message happens to be “interrupted”; keying behavior off that string would make the difference between “your rule looped forever” and “your rule threw” depend on wording this project does not control. A different engine’s own interrupted-execution signal would be exactly as unreliable to string-match, for the same reason.

Implementations

impl Budget

pub fn new(clock: Arc<RunClock>) -> Arc<Self>

Build a budget enforcer sharing the run’s clock.

pub fn arm(&self, rule_timeout: Duration)

Start the clock on one invocation.

pub fn disarm(&self)

Stop enforcing an invocation budget.

pub fn should_interrupt(&self) -> bool

Whether execution should stop now, recording why. Called by the engine’s interrupt handler, so it runs often and must stay cheap.

pub fn take_trip(&self) -> Option<Trip>

Which budget was breached, if any. Clears the record.

pub fn clock(&self) -> &RunClock

The run clock this budget was built from.

Trait Implementations

impl Debug for Budget

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

Formats the value using the given formatter.