Struct BudgetTracker 

pub struct BudgetTracker {
    pub errors_emitted: usize,
    pub current_depth: usize,
    pub max_depth_reached: usize,
    pub tokens_skipped: usize,
    pub recoveries_attempted: usize,
}

Tracks budget consumption during parsing.

This struct monitors how much of the parse budget has been used and provides methods to check and consume budget atomically.

Fields

errors_emitted: usize

Number of errors emitted so far.

current_depth: usize

Current nesting depth.

max_depth_reached: usize

Maximum depth reached during parse.

tokens_skipped: usize

Total tokens skipped across all recovery attempts.

recoveries_attempted: usize

Number of recovery attempts made.

Implementations

impl BudgetTracker

pub fn new() -> BudgetTracker

Create a new budget tracker.

pub fn errors_exhausted(&self, budget: &ParseBudget) -> bool

Check if error budget is exhausted.

pub fn depth_would_exceed(&self, budget: &ParseBudget) -> bool

Check if depth budget would be exceeded by going one level deeper.

pub fn skip_would_exceed(&self, budget: &ParseBudget, count: usize) -> bool

Check if skip budget would be exceeded by skipping count more tokens.

pub fn recoveries_exhausted(&self, budget: &ParseBudget) -> bool

Check if recovery budget is exhausted.

pub fn begin_recovery(&mut self, budget: &ParseBudget) -> bool

Begin a recovery attempt, checking budget first.

Returns false if another recovery attempt would exceed the budget. If this returns true, the recovery attempt has been recorded.

pub fn can_skip_more(&self, budget: &ParseBudget, additional: usize) -> bool

Check if skipping additional more tokens would stay within budget.

This considers both already-skipped tokens and the proposed additional count.

pub fn record_error(&mut self)

Record an error emission.

pub fn enter_depth(&mut self)

Enter a deeper nesting level.

pub fn exit_depth(&mut self)

Exit a nesting level.

pub fn record_skip(&mut self, count: usize)

Record tokens skipped during recovery.

pub fn record_recovery(&mut self)

Record a recovery attempt.

Trait Implementations

impl Clone for BudgetTracker

fn clone(&self) -> BudgetTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BudgetTracker

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

Formats the value using the given formatter.

impl Default for BudgetTracker

fn default() -> BudgetTracker

Returns the “default value” for a type.