nedb-engine 2.0.4__tar.gz → 2.0.5__tar.gz

{nedb_engine-2.0.4 → nedb_engine-2.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nedb-engine
-Version: 2.0.4
+Version: 2.0.5
 Summary: NEDB — a versioned, self-compressing, time-traveling embedded database (replay-protected, idempotent, relational, searchable) with durable AOF persistence and a server daemon (nedbd).
 Project-URL: Homepage, https://github.com/Eth-Interchained/nedb
 Project-URL: Repository, https://github.com/Eth-Interchained/nedb

nedb_engine-2.0.5/client/python/README.md

@@ -0,0 +1,55 @@
+# nedb-client (Python)
+
+Async Python client for the [nedbd](https://github.com/Eth-Interchained/nedb) HTTP API.
+
+```bash
+pip install nedb-client
+```
+
+## Quick start
+
+```python
+from nedb_client import NedbClient
+
+async with NedbClient("http://127.0.0.1:7070", db="mydb") as db:
+    # Write
+    await db.put("blocks", "618000", {"height": 618000, "hash": "000abc"})
+
+    # Query (full NQL)
+    rows = await db.query("FROM blocks ORDER BY height DESC LIMIT 10")
+
+    # Causal provenance + bi-temporal
+    result = await db.put("claims", "c1", {"fact": "..."}, 
+                          caused_by=["abc123..."],
+                          valid_from="2024-01-01",
+                          evidence="sensor-42")
+
+    # Merkle head (tamper-evident root)
+    head = await db.head()
+
+    # Full tamper-evidence check
+    report = await db.verify()
+    assert report["ok"]
+```
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `put(coll, id, doc, **meta)` | Write a document |
+| `get(coll, id)` | Fetch current version |
+| `delete(coll, id)` | Tombstone delete |
+| `query(nql)` | NQL query → list of dicts |
+| `query_full(nql)` | NQL query → full response with seq + head |
+| `batch(ops)` | Batch put/del in one round-trip |
+| `create_index(coll, field)` | Create sorted index |
+| `verify()` | BLAKE2b tamper-evidence check |
+| `head()` | Current Merkle head |
+| `seq()` | Current sequence number |
+| `checkpoint()` | Explicit checkpoint |
+| `log(limit)` | Recent write log |
+| `health()` | Server health |
+| `ping()` | Boolean reachability check |
+| `list_databases()` | All databases on server |
+| `create_database()` | Create this database |
+| `drop_database()` | Drop this database |

{nedb_engine-2.0.4 → nedb_engine-2.0.5}/pyproject.toml

@@ -10,7 +10,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nedb-engine"
-version = "2.0.4"
+version = "2.0.5"
 description = "NEDB — a versioned, self-compressing, time-traveling embedded database (replay-protected, idempotent, relational, searchable) with durable AOF persistence and a server daemon (nedbd)."
 readme = "README.md"
 requires-python = ">=3.8"

{nedb_engine-2.0.4 → nedb_engine-2.0.5}/python/nedb/__init__.py

@@ -47,4 +47,4 @@ __all__ = [
     "wrap_redis", "WrappedRedis",
     "_native", "__has_native__",
 ]
-__version__ = "2.0.4"
+__version__ = "2.0.5"