feat: Python bindings for embedded mode (clickgraph-py)

[genezhang]

Summary

Adds a clickgraph Python package (via PyO3 + maturin) that exposes the embedded graph query engine to Python users.

Usage

import clickgraph

db = clickgraph.Database("schema.yaml")
conn = db.connect()

for row in conn.query("MATCH (u:User) RETURN u.name LIMIT 5"):
    print(row["u.name"])

API

Class	Method	Description
Database	__init__(schema_path, **kwargs)	Open embedded database with optional credentials
Database	connect()	Create a Connection
Database	execute(cypher)	Shorthand: query without explicit connection
Connection	query(cypher)	Execute Cypher, return iterable QueryResult
Connection	query_to_sql(cypher)	Translate Cypher to SQL (debug)
QueryResult	iteration, len(), column_names, num_rows, as_dicts(), get_row(i)	Result access

All credential kwargs (S3, GCS, Azure) are passed through to StorageCredentials.

Changes

• New crate: clickgraph-py/ — PyO3 bindings wrapping clickgraph-embedded
• Workspace: Added clickgraph-py to workspace members
• Tests: 14 passing Python tests, 5 skipped (require chdb runtime)
• Docs: Updated Embedded-Mode wiki with Python library section
• Cleanup: Removed unused Row import in clickgraph-embedded

Install

cd clickgraph-py
pip install maturin
maturin develop

[Copilot]

Pull request overview

Adds first-party Python bindings for ClickGraph embedded mode (clickgraph Python package) using PyO3/maturin, exposing an embedded Database/Connection/QueryResult API and documenting Python usage alongside existing embedded-mode options.

Changes:

• Introduces new clickgraph-py/ crate/package with PyO3 bindings, packaging metadata, and pytest-based tests.
• Updates the Rust workspace to include clickgraph-py and updates Cargo.lock accordingly.
• Updates embedded-mode documentation to include a Python library option; removes an unused Rust import in clickgraph-embedded.

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
docs/wiki/Embedded-Mode.md	Documents Python embedded-mode usage as an additional option.
clickgraph-py/src/lib.rs	Implements PyO3 bindings for Database, Connection, and QueryResult.
clickgraph-py/python/clickgraph/init.py	Exposes the compiled extension module as a Python package API.
clickgraph-py/pyproject.toml	Defines Python build system and maturin configuration.
clickgraph-py/README.md	Provides Python user-facing documentation and examples.
clickgraph-py/Cargo.toml	Defines the Rust cdylib crate for the Python extension.
clickgraph-py/.gitignore	Ignores common Python/build artifacts for the new package.
clickgraph-py/tests/test_bindings.py	Adds pytest coverage for bindings and SQL translation behavior.
clickgraph-embedded/src/connection.rs	Removes an unused Row import.
Cargo.toml	Adds clickgraph-py to workspace members.
Cargo.lock	Adds PyO3 and clickgraph-py dependency resolution entries.