README.md

GFQL Cypher TCK Conformance Harness

This repo hosts the Cypher TCK -> GFQL translation harness used by PyGraphistry. It relies on an installed pygraphistry package to execute GFQL queries and validate results.

Layout

• tests/cypher_tck/: Scenario translations, runner, and gap analysis.
• TCK clone (gitignored): plans/cypher-tck-conformance/tck.
• Sync guide: SYNC.md.

Links

• PyGraphistry repo: graphistry/pygraphistry
• GFQL docs: pygraphistry.readthedocs.io
• openCypher TCK: opencypher/openCypher
• Contributing: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Security: SECURITY.md

Setup

1. Install or editable-link pygraphistry:

   pip install -e /path/to/pygraphistry

2. Clone the openCypher TCK locally (gitignored):

   mkdir -p plans/cypher-tck-conformance
   git clone https://github.com/opencypher/openCypher plans/cypher-tck-conformance/tck

Run

pytest tests/cypher_tck -xvs
TEST_CUDF=1 pytest tests/cypher_tck -xvs

Local pygraphistry override

Use a sibling checkout without installing by setting PYGRAPHISTRY_PATH:

PYGRAPHISTRY_PATH=../pygraphistry2 ./bin/ci.sh

Install a specific ref from GitHub:

PYGRAPHISTRY_INSTALL=1 PYGRAPHISTRY_REF=master ./bin/ci.sh

License

This repository is licensed under the Apache License 2.0. See LICENSE and NOTICE for details and upstream attribution.