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,
}

Parse error, budget, and output types. Error types and result aliases used by the parser engine. 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.