Struct ParseConfig 

pub struct ParseConfig {
    pub reject_unknown: bool,
    pub abort_on_error: bool,
    pub max_group_depth: usize,
}

Parse-time configuration knobs.

ParseConfig is plain data describing how a single parse call should behave. It is independent of ParseContext, which owns the knowledge base; the same context can be reused across many calls with different configs.

Two orthogonal axes control parsing, both with true = stricter:

• reject_unknown: unknown command/environment names become diagnostics (true) or known: false nodes (false).
• abort_on_error: stop at the first error (true) or continue parsing to collect every diagnostic (false, slower). Recovery may return a read-only document containing Error nodes; use ParseResult::try_into_document when downstream code requires a complete tree.

Named extremes STRICT and LENIENT cover the two corners where both axes agree. For mixed settings, use struct-update syntax, e.g. ParseConfig { reject_unknown: true, ..Default::default() }.

Fields

reject_unknown: bool

When true, unknown command/environment names become diagnostics instead of being preserved as known: false nodes.

This controls unknown-name handling only, not general error strictness.

abort_on_error: bool

When true, parsing stops at the first error in each content item and may return no document for that item.

When false, the parser uses recovery fallbacks to collect every diagnostic (useful for IDEs and playgrounds, but slower on large corpora) and may attach Error nodes to the returned document. A document with error nodes is read-only and cannot be used by transform entry points.

max_group_depth: usize

Hard upper bound on nested { ... } brace group depth.

Implementations

impl ParseConfig

pub const DEFAULT_MAX_GROUP_DEPTH: usize = 128

Default hard upper bound on nested { ... } brace group depth.

pub const STRICT: Self

Both axes strict: reject_unknown = true, abort_on_error = true.

Used by normalization and other correctness-sensitive paths.

pub const LENIENT: Self

Both axes lenient: reject_unknown = false, abort_on_error = false.

Default for standalone parse-only entry points and interactive tools.

Trait Implementations

impl Clone for ParseConfig

fn clone(&self) -> ParseConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParseConfig

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

Formats the value using the given formatter.

impl Default for ParseConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ParseConfig

impl PartialEq for ParseConfig

fn eq(&self, other: &ParseConfig) -> 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 StructuralPartialEq for ParseConfig