Skip to content

cypher_tck

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

cypher_tck

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
analysis
analysis
 
 
scenarios
scenarios
 
 
GAP_ANALYSIS.md
GAP_ANALYSIS.md
 
 
README.md
README.md
 
 
direct_cypher_support.py
direct_cypher_support.py
 
 
direct_cypher_xfail_contract.py
direct_cypher_xfail_contract.py
 
 
gap_priority.py
gap_priority.py
 
 
gfql_plan.py
gfql_plan.py
 
 
lane_contracts.py
lane_contracts.py
 
 
models.py
models.py
 
 
parse_cypher.py
parse_cypher.py
 
 
phase_support.py
phase_support.py
 
 
plan_executor.py
plan_executor.py
 
 
porting_backlog.py
porting_backlog.py
 
 
report.py
report.py
 
 
sweep_direct_cypher.py
sweep_direct_cypher.py
 
 
sweep_promotions.py
sweep_promotions.py
 
 
test_direct_cypher_contract_fastfail.py
test_direct_cypher_contract_fastfail.py
 
 
test_lane_contracts.py
test_lane_contracts.py
 
 
test_parse_cypher.py
test_parse_cypher.py
 
 
test_plan_executor_collect.py
test_plan_executor_collect.py
 
 
test_plan_executor_compile_validation.py
test_plan_executor_compile_validation.py
 
 
test_plan_executor_list_expr.py
test_plan_executor_list_expr.py
 
 
test_plan_executor_match_compile.py
test_plan_executor_match_compile.py
 
 
test_plan_executor_order_by.py
test_plan_executor_order_by.py
 
 
test_plan_executor_strict_pure_regressions.py
test_plan_executor_strict_pure_regressions.py
 
 
test_plan_executor_string_ops.py
test_plan_executor_string_ops.py
 
 
test_plan_executor_temporal_duration.py
test_plan_executor_temporal_duration.py
 
 
test_report.py
test_report.py
 
 
test_sweep_direct_cypher.py
test_sweep_direct_cypher.py
 
 
test_tck_runner.py
test_tck_runner.py
 
 
test_workflow_action_versions.py
test_workflow_action_versions.py
 
 

README.md

Cypher TCK conformance tests (GFQL)

This suite translates a subset of the openCypher TCK into GFQL AST/wire protocol queries and validates results against the reference enumerator and pandas, with optional cuDF runs when enabled.

Source of truth

Provenance

  • Clone date: 2025-12-29
  • Repo commit: 59edf2e1c17b845bf97c334ed06b2eb780950c13
  • License: Apache License 2.0 (plans/cypher-tck-conformance/tck/LICENSE)

Goals

  • Translate supported Cypher scenarios into GFQL equivalents.
  • Run each translated case on:
    • Reference enumerator (oracle)
    • engine='pandas'
    • engine='cudf' (only when TEST_CUDF=1 and cudf is available)
  • Record unsupported scenarios with explicit xfail/skip reasons and capability tags.
  • Preserve traceability to the original Cypher query and expected results.
    • Capability tags include target-table-ops, target-expr-dsl, defer-quantifier, defer-path-enum, defer-unwind, defer-union.

Running

pytest tests/cypher_tck -xvs
TEST_CUDF=1 pytest tests/cypher_tck -xvs
PYGRAPHISTRY_PATH=/path/to/pygraphistry python -m tests.cypher_tck.report

Porting backlog

PYGRAPHISTRY_PATH=/path/to/pygraphistry python -m tests.cypher_tck.porting_backlog
python -m tests.cypher_tck.porting_backlog
BACKLOG_LIMIT=20 python -m tests.cypher_tck.porting_backlog

Notes

  • The TCK repo is not vendored; use the local clone under plans/.
  • Each translated scenario should include a reference back to the TCK path, the original Cypher, and the expected rows or aggregates.
  • For xfail scenarios, gfql may contain a non-executable plan built with tests.cypher_tck.gfql_plan to document the intended translation. When a target-table-ops or target-expr-dsl scenario lacks a manual plan, a minimal clause-based plan is generated from the Cypher text at load time.
  • Track feature gaps and workarounds in tests/cypher_tck/GAP_ANALYSIS.md.
  • tests.cypher_tck.report now emits both conformance counts and a reusable lane-priority view for backlog planning, including tracker placeholders for the current top candidate workstreams.