Struct ExecutionCounters 

pub struct ExecutionCounters {
    pub commands: usize,
    pub function_depth: usize,
    pub loop_iterations: usize,
    pub total_loop_iterations: usize,
    pub session_commands: u64,
    pub session_exec_calls: u64,
}

Execution counters for tracking resource usage

Fields

commands: usize

Number of commands executed

function_depth: usize

Current function call depth

loop_iterations: usize

Number of iterations in current loop (reset per-loop)

total_loop_iterations: usize

Total loop iterations across all loops (never reset)

session_commands: u64

Total commands across all exec() calls in this session.

session_exec_calls: u64

Number of exec() invocations in this session.

Implementations

impl ExecutionCounters

pub fn new() -> Self

Create new counters

pub fn reset_for_execution(&mut self)

Reset counters for a new exec() invocation. Each exec() is a separate script and gets its own budget. This prevents a prior exec() from permanently poisoning the session.

pub fn tick_command( &mut self, limits: &ExecutionLimits, ) -> Result<(), LimitExceeded>

Increment command counter, returns error if limit exceeded

pub fn check_session_limits( &self, session_limits: &SessionLimits, ) -> Result<(), LimitExceeded>

Check session-level limits. Called at exec() entry and during execution.

pub fn tick_exec_call(&mut self)

Increment exec call counter for session tracking.

pub fn tick_loop( &mut self, limits: &ExecutionLimits, ) -> Result<(), LimitExceeded>

Increment loop iteration counter, returns error if limit exceeded

pub fn reset_loop(&mut self)

Reset loop iteration counter (called when entering a new loop)

pub fn push_function( &mut self, limits: &ExecutionLimits, ) -> Result<(), LimitExceeded>

Push function call, returns error if depth exceeded

pub fn pop_function(&mut self)

Pop function call

Trait Implementations

impl Clone for ExecutionCounters

fn clone(&self) -> ExecutionCounters

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecutionCounters

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

Formats the value using the given formatter.

impl Default for ExecutionCounters

fn default() -> ExecutionCounters

Returns the “default value” for a type.