Skip to main content

Cypher frontend compiler that lowers Neo4j-like Cypher into SQLGlot AST

Project description

CypherGlot

CypherGlot is the Cypher frontend compiler for the HumemAI stack.

Its intended job is:

raw Cypher string
→ parse
→ Cypher AST
→ compile
→ SQLGlot AST

It is intentionally not a database engine. It should not execute SQL, execute vector search, or own storage. Its main product is a SQLGlot Expression tree that a host runtime such as humemdb can plan and execute.

Status

The repository is currently in the compiler-foundation stage. The packaging, testing, documentation, and release workflows are in place so the repo can be published and documented consistently while the parser and lowering surface is filled in.

Install

pip install cypherglot

Documentation

Development

Run the unit tests:

python -m unittest discover -s tests -v

Build the docs locally:

uv sync --group docs
uv run mkdocs build --strict

The roadmap lives in things-to-do.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cypherglot-0.0.0.tar.gz (52.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cypherglot-0.0.0-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file cypherglot-0.0.0.tar.gz.

File metadata

  • Download URL: cypherglot-0.0.0.tar.gz
  • Upload date:
  • Size: 52.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cypherglot-0.0.0.tar.gz
Algorithm Hash digest
SHA256 86fe2e4b28643136d1d6787b4f3493b6c7ad51ce2718f7351fe14136e473f79f
MD5 6bbec9a4f6581ace31e648a66b2b719a
BLAKE2b-256 6fc904632f6b39e5c26c9f5150ccff4eb025b9cf436b9b50b2de483898cb9250

See more details on using hashes here.

Provenance

The following attestation bundles were made for cypherglot-0.0.0.tar.gz:

Publisher: publish-pypi.yml on humemai/cypherglot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cypherglot-0.0.0-py3-none-any.whl.

File metadata

  • Download URL: cypherglot-0.0.0-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cypherglot-0.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6226f2c3f975de330c6d4a999758de5821ada55960b3fe19db7c5e94194b3817
MD5 8b52afd5afff983654a16db6c8bfbada
BLAKE2b-256 80cda2bdd1daac62083c5b6f004da9408fce9be6bbcd6cacb1249b5b26fcf110

See more details on using hashes here.

Provenance

The following attestation bundles were made for cypherglot-0.0.0-py3-none-any.whl:

Publisher: publish-pypi.yml on humemai/cypherglot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page