lora_parser/parser/
mod.rs

1//! Pest-driven Cypher parser: lower a raw query string into a [`lora_ast::Document`].
2//!
3//! Layout:
4//! - `query` — top-of-tree query-shape lowerings (`regular_query`,
5//!   `single_query`, `multi_part_query`, `query_part`, `single_part_query`,
6//!   `reading_clause`, `updating_clause`).
7//! - `clauses` — clause-level lowerings (MATCH, UNWIND, CREATE, MERGE,
8//!   DELETE, SET, REMOVE, CALL, YIELD, WITH, WHERE, RETURN, projection
9//!   body / items, ORDER BY, sort items).
10//! - `patterns` — graph-pattern lowerings (pattern, pattern part,
11//!   shortest-path pattern, pattern element + chain, node / relationship
12//!   patterns, range literals, properties).
13//! - `expressions` — operator-precedence chain from `expression` down
14//!   through comparison / add / mul / pow / unary / postfix and CASE.
15//! - `literals` — leaves of the expression tree: literals, strings,
16//!   maps, lists, comprehensions, parameters, list predicates, REDUCE,
17//!   EXISTS subqueries, function calls, name-part / variable / symbolic
18//!   / schema-name / integer-literal lowerings.
19//! - `util` — small helpers shared across the lowerings (`single_inner`,
20//!   `pair_span`, `merge_spans`, `unexpected_rule`).
21//! - `tests` — unit tests covering the parser surface.
22
23use crate::errors::ParseError;
24use lora_ast::*;
25use pest::iterators::Pair;
26use pest::Parser;
27
28mod clauses;
29mod expressions;
30mod literals;
31mod patterns;
32mod query;
33mod util;
34
35#[cfg(test)]
36mod tests;
37
38use clauses::lower_standalone_call;
39use query::lower_regular_query;
40use util::{pair_span, unexpected_rule};
41
42#[derive(pest_derive::Parser)]
43#[grammar = "cypher.pest"]
44pub(super) struct LoraParser;
45
46pub fn parse_query(input: &str) -> Result<Document, ParseError> {
47    let mut pairs = LoraParser::parse(Rule::query, input)
48        .map_err(|e| ParseError::new(e.to_string(), 0, input.len()))?;
49
50    let pair = pairs
51        .next()
52        .ok_or_else(|| ParseError::new("expected query", 0, input.len()))?;
53
54    lower_query(pair)
55}
56
57fn lower_query(pair: Pair<Rule>) -> Result<Document, ParseError> {
58    let span = pair_span(&pair);
59    let mut inner = pair.into_inner();
60
61    let stmt = inner
62        .find(|p| p.as_rule() == Rule::statement)
63        .ok_or_else(|| ParseError::new("expected statement", span.start, span.end))?;
64
65    Ok(Document {
66        statement: lower_statement(stmt)?,
67        span,
68    })
69}
70
71fn lower_statement(pair: Pair<Rule>) -> Result<Statement, ParseError> {
72    let inner = util::single_inner(pair)?;
73    match inner.as_rule() {
74        Rule::regular_query => Ok(Statement::Query(Query::Regular(lower_regular_query(
75            inner,
76        )?))),
77        Rule::standalone_call => Ok(Statement::Query(Query::StandaloneCall(
78            lower_standalone_call(inner)?,
79        ))),
80        _ => Err(unexpected_rule("statement", inner)),
81    }
82}
lora_parser/parser/mod.rs

lora_parser/parser/
mod.rs
