Struct Parser 

pub struct Parser { /* private fields */ }

Parser configuration.

Implementations

impl Parser

pub fn new() -> Self

Create a new parser.

pub fn threads(self, threads: impl Into<Option<usize>>) -> Self

Set number of threads (None = use all available)

pub const fn tolerant(self) -> Self

Continue after malformed blocks and collect diagnostics.

pub const fn capture_source(self) -> Self

Capture source spans for blocks.

pub const fn preserve_raw(self) -> Self

Preserve exact raw source text in parsed-document output.

pub const fn expand_values(self) -> Self

Populate expanded value text in parsed-document output.

pub fn parse<'a>(&self, input: &'a str) -> Result<Library<'a>>

Parse a single input string.

pub fn parse_document<'a>(&self, input: &'a str) -> Result<ParsedDocument<'a>>

Parse a single input string into the parsed document model.

Use this when a caller needs source-order blocks, diagnostics, raw-text slots, or partial parse results. Use Self::parse for the compact Library API.

pub fn parse_source<'a>( &self, source_name: impl Into<Cow<'a, str>>, input: &'a str, ) -> Result<ParsedDocument<'a>>

Parse a named source into the parsed document model.

The parser does not read files itself; callers provide the source name or path-like label together with the already-loaded input text.

pub fn parse_sources<'a>( &self, sources: &[CorpusSource<'a>], ) -> Result<ParsedCorpus<'a>>

Parse multiple named in-memory sources into a corpus result.

pub fn parse_events<'a, F>( &self, input: &'a str, on_event: F, ) -> Result<StreamingSummary>

where F: FnMut(ParseEvent<'a>) -> Result<ParseFlow>,

Stream parsed source-order events to a callback.

Strict mode returns an error on the first malformed block. Tolerant mode emits recovered partial entries or failed blocks with diagnostics and continues. The callback can return ParseFlow::Stop to stop after the current event; the returned summary then has stopped = true.

pub fn parse_source_events<'a, F>( &self, source_name: impl Into<Cow<'a, str>>, input: &'a str, on_event: F, ) -> Result<StreamingSummary>

where F: FnMut(ParseEvent<'a>) -> Result<ParseFlow>,

Stream parsed source-order events from a named source.

pub fn parse_corpus_events<'a, F>( &self, sources: &[CorpusSource<'a>], on_event: F, ) -> Result<StreamingSummary>

where F: FnMut(CorpusEvent<'a>) -> Result<ParseFlow>,

Stream events from multiple named in-memory sources in corpus order.

pub fn parse_files<P: AsRef<Path> + Sync>( &self, paths: &[P], ) -> Result<Library<'static>>

Parse multiple files in parallel

Trait Implementations

impl Clone for Parser

fn clone(&self) -> Parser

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Parser

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

Formats the value using the given formatter.

impl Default for Parser

fn default() -> Parser

Returns the “default value” for a type.