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 schema;
34mod util;
35
36#[cfg(test)]
37mod tests;
38
39use clauses::lower_standalone_call;
40use query::lower_regular_query;
41use schema::lower_schema_command;
42use util::{pair_span, unexpected_rule};
43
44#[derive(pest_derive::Parser)]
45#[grammar = "cypher.pest"]
46pub(super) struct LoraParser;
47
48pub fn parse_query(input: &str) -> Result<Document, ParseError> {
49    let mut pairs = LoraParser::parse(Rule::query, input)
50        .map_err(|e| ParseError::new(e.to_string(), 0, input.len()))?;
51
52    let pair = pairs
53        .next()
54        .ok_or_else(|| ParseError::new("expected query", 0, input.len()))?;
55
56    lower_query(pair)
57}
58
59fn lower_query(pair: Pair<Rule>) -> Result<Document, ParseError> {
60    let span = pair_span(&pair);
61    let mut inner = pair.into_inner();
62
63    let stmt = inner
64        .find(|p| p.as_rule() == Rule::statement)
65        .ok_or_else(|| ParseError::new("expected statement", span.start, span.end))?;
66
67    Ok(Document {
68        statement: lower_statement(stmt)?,
69        span,
70    })
71}
72
73fn lower_statement(pair: Pair<Rule>) -> Result<Statement, ParseError> {
74    let inner = util::single_inner(pair)?;
75    match inner.as_rule() {
76        Rule::regular_query => Ok(Statement::Query(Query::Regular(lower_regular_query(
77            inner,
78        )?))),
79        Rule::standalone_call => Ok(Statement::Query(Query::StandaloneCall(
80            lower_standalone_call(inner)?,
81        ))),
82        Rule::schema_command => Ok(Statement::Schema(lower_schema_command(inner)?)),
83        _ => Err(unexpected_rule("statement", inner)),
84    }
85}
lora_parser/parser/mod.rs

lora_parser/parser/
mod.rs
