Struct ParseBudget 

pub struct ParseBudget {
    pub max_errors: usize,
    pub max_depth: usize,
    pub max_tokens_skipped: usize,
    pub max_recoveries: usize,
}

Budget limits for parser operations to prevent runaway parsing.

These limits ensure the parser terminates in bounded time even when processing malformed or adversarial input. Each budget parameter has a sensible default that works for most real-world Perl code.

Usage

use perl_error::ParseBudget;

// Use defaults for normal parsing
let budget = ParseBudget::default();

// Stricter limits for untrusted input
let strict = ParseBudget {
    max_errors: 10,
    max_depth: 64,
    max_tokens_skipped: 100,
    max_recoveries: 50,
};

Fields

max_errors: usize

Maximum number of errors to collect before giving up. After this limit, parsing stops to avoid flooding diagnostics. Default: 100

max_depth: usize

Maximum nesting depth for recursive constructs (blocks, expressions). Prevents stack overflow on deeply nested input. Default: 256

max_tokens_skipped: usize

Maximum tokens to skip during a single recovery attempt. Prevents infinite loops when recovery can’t find a sync point. Default: 1000

max_recoveries: usize

Maximum number of recovery attempts per parse. Bounds total recovery work to prevent pathological cases. Default: 500

Implementations

impl ParseBudget

pub fn for_ide() -> ParseBudget

Create a budget suitable for IDE/LSP usage with generous limits.

pub fn strict() -> ParseBudget

Create a strict budget for parsing untrusted input.

pub fn unlimited() -> ParseBudget

Create an unlimited budget (use with caution).

Trait Implementations

impl Clone for ParseBudget

fn clone(&self) -> ParseBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParseBudget

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

Formats the value using the given formatter.

impl Default for ParseBudget

fn default() -> ParseBudget

Returns the “default value” for a type.

impl PartialEq for ParseBudget

fn eq(&self, other: &ParseBudget) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ParseBudget

impl Eq for ParseBudget

impl StructuralPartialEq for ParseBudget