littlegraph-python 0.2.1

Python extension module for the littlegraph embedded graph database
Documentation

littlegraph Python binding

This directory contains the in-process Python binding for littlegraph. The binding opens Neo4j record-store directories directly; it is not the official Neo4j Python driver and it does not connect to Bolt or HTTP endpoints.

The binding is under active development. Read-only access is the default. Writable access requires exclusive offline ownership of the database directory and must not be used while Neo4j is running against the same store.

Current API

Build an editable installation from the repository root:

maturin develop -m crates/python/Cargo.toml

Open a store with a context manager and use parameters for user values:

import littlegraph

with littlegraph.open(
    "/path/to/data/databases/neo4j",
    read_only=False,
    create=True,
) as database:
    result = database.execute(
        "CREATE (n:Person {name: $name}) RETURN n",
        {"name": "Alice"},
    )
    print(result[0]["n"])

The current implementation includes bounded parameter and result conversion, auto-commit execution, graph value objects, structured errors, GIL-free worker waits, and deterministic close. Explicit transactions, savepoints, and their public cancellation handle are the next implementation phase.