Documentation
¶
Overview ¶
Package gql contains the GSEER Query Language implementation: lexer → parser → ast → validator → planner (SPEC-04).
M1: package skeleton only (this doc.go and the sub-package doc.go files). The execution order per the Phase 1 plan is M5 (lexer) → M8 (ast) → M6 (parser) → M7 (validator) → M9 (planner). M1 lands the package layout per SPEC-02 §2 so the import-graph test (AC-3.1) can pin the absence of collector/egress dependencies from the very first commit.
The gql package never imports any collector, egress, or P2 package (ADR-0010 Search ≠ Scan).
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package ast holds the typed GQL tree + visitor + explain rendering (SPEC-04 §4).
|
Package ast holds the typed GQL tree + visitor + explain rendering (SPEC-04 §4). |
|
Package lexer is the GQL token stream producer (SPEC-04 §2–3).
|
Package lexer is the GQL token stream producer (SPEC-04 §2–3). |
|
Package parser is the recursive-descent GQL parser (SPEC-04 §3 EBNF).
|
Package parser is the recursive-descent GQL parser (SPEC-04 §3 EBNF). |
|
Package planner compiles the validated GQL AST to parameterized PostgreSQL SQL against the search_index union view (SPEC-04 §6, §8).
|
Package planner compiles the validated GQL AST to parameterized PostgreSQL SQL against the search_index union view (SPEC-04 §6, §8). |
|
Package plannersqlite lowers a validated GQL AST to parameterized SQL for the SQLite personal-mode engine (database/sql + modernc driver).
|
Package plannersqlite lowers a validated GQL AST to parameterized SQL for the SQLite personal-mode engine (database/sql + modernc driver). |
|
Package validator is the GQL semantic validator (SPEC-04 §5, §7).
|
Package validator is the GQL semantic validator (SPEC-04 §5, §7). |
Click to show internal directories.
Click to hide internal directories.