pywitdb

Python bindings for WitDatabase — embedded ACID store (.witdb).

Org: AI-Guiders
Upstream engine: OutWit.Database.Core (NuGet)
Scope: door-to-singularity / [PRIMARY:PYWDB]

Status

Early bootstrap: ADR-001 accepted; MVP bridge implementation in progress.

Target API

import pywitdb

with pywitdb.open("store.witdb", password="...") as db:
    with db.transaction():
        db.put(b"meta:fv", b"94266")
        assert db.get(b"meta:fv") == b"94266"

Architecture

See docs/adr/0001-binding-architecture-bridge-and-native.md.

Phase	Binding	Purpose
MVP	JSON subprocess bridge (witdb-bridge .NET CLI)	Ship open / KV / transaction; cross-lang contract tests
v1 prod	NativeAOT C ABI + ctypes wheels	Low latency, no .NET runtime dependency in Python process

Development

python -m pip install -e ".[dev]"
pytest

Bridge CLI and C# fixture tests land in follow-up PRs (ADR-0001 § Implementation plan).

License

Apache-2.0 — aligned with WitDatabase.