CYPHER
Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.
Cypher Query Preview.
At a glance
| Purpose | A Cypher query file: graph queries for Neo4j and other property-graph databases. |
| Extensions | .cypher |
| Poka parser | poka-cypher |
| Viewer | poka-metadata-card-viewer |
| Depth tier | Metadata card (see Depth tiers) |
| Breadth tier | B4 Summary (see Breadth tiers) |
How much Poka reads
B4 Summary. The container and metadata are read and summarised (counts, properties, structure), but the main content is not rendered.
Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-cypher/src/main.rs (234 lines) and plugin.json in full. The crate has no unit tests and no tests/samples.rs, and the corpus has no .cypher and .cql sample, so the tier rests on reading the code. Covers .cypher and .cql. The output is a metadata card of counts found by matching text line by line: a distribution of clauses (MATCH, OPTIONAL MATCH, CREATE, MERGE, DELETE, RETURN, WHERE, WITH, UNWIND, SET, CALL), distinct clauses, constraint and index operations, estimated node and relationship patterns, directed relationships, parameter references, statement separators, comment lines and the labels and relationship types seen. Judgement: B4, because the structure is summarised but the source itself is never shown.
What Poka does not read
- The source text is not shown: the card carries only counts and a few sample names, with no code view or highlighting
- Constructs are found by matching text line by line, not by parsing, so multi-line declarations, nested or indented definitions and keywords inside strings or comments can be miscounted
- Counts of named items stop where their name list is capped (labels at 64), so a larger file under-reports them
- Files over 64 MiB are cut to the first 64 MiB (the card says so)
- Text that is not UTF-8 is decoded with replacement characters; no other encoding is tried
- Node and relationship patterns are estimated from bracket characters, not parsed
Libraries
Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.
- decypher (candidate; EUPL-1.2 OR MIT OR Apache-2.0; Rust; https://docs.rs/crate/decypher/latest) — openCypher parser with typed AST and source spans; alpha release (0.2.0-alpha.6), unstable API.
Sources
- parsers/poka-cypher/src/main.rs
- parsers/poka-cypher/plugin.json