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:

```text
maturin develop -m crates/python/Cargo.toml
```

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

```python
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.