Struct ParseBudget 

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

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