sql-dialect-fmt-parser 0.1.0

Error-resilient, event-based recursive-descent parser building a lossless rowan CST for Snowflake SQL.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

//! The flat event stream the parser emits.
//!
//! The grammar never touches the tree directly: it pushes [`Event`]s, and a separate pass
//! ([`crate::builder::build_tree`]) replays them into a `rowan` `GreenNodeBuilder`, re-inserting
//! trivia (whitespace/comments) so the resulting CST is byte-exact-lossless.

use sql_dialect_fmt_syntax::SyntaxKind;

pub(crate) enum Event {
    /// Open a node. The kind is a placeholder ([`SyntaxKind::ERROR`]) until the matching
    /// `Marker` is completed, at which point it is overwritten with the real kind.
    Open { kind: SyntaxKind },
    /// Close the most recently opened, still-open node.
    Close,
    /// Consume the next meaningful (non-trivia) token, tagging it with `kind` (which may be a
    /// keyword kind remapped from a raw `IDENT`).
    Advance { kind: SyntaxKind },
    /// An abandoned `Open`: the builder skips it, leaving any children attached to the parent. Used
    /// for speculative wrappers that turn out not to be needed (see [`crate::parser::Marker::abandon`]).
    Tombstone,
}