# 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.