Struct Parser 

pub struct Parser;

Canonical QQL parser facade.

Production parsing is only the hand-written AST lowerer (lexer → tokens → typed AST). There is no parallel PEG/pest frontend in this crate: language/v1/grammar.pest is the language contract for docs and CI (qql-grammar-gen), not a runtime dependency of qql-core.

Implementations

impl Parser

pub fn parse(input: &str) -> Result<Stmt, QqlError>

Parses a single QQL statement from the input string.

pub fn parse_all(input: &str) -> Result<Vec<Stmt>, QqlError>

Parses a ;-separated script into a list of statements.

pub fn parse_all_with_spans(input: &str) -> Result<Vec<(Stmt, Span)>, QqlError>

Parses a script, returning each statement paired with its source span.

pub fn parse_all_recovering(input: &str) -> RecoveredScript

Parse a script in panic-mode recovery: sync on ; or the next statement keyword and collect every recoverable error.

Self::parse / Self::parse_all stay fail-fast — execution must not run a partial script. This entry point is for IDEs, analyze, and other diagnostic surfaces that want every span in one pass.

pub fn parse_value(input: &str) -> Result<Value, QqlError>

Parse a standalone literal value (string, number, boolean, null, list, or dict).

Errors if parsing fails or if unexpected trailing tokens exist after the value.