lora-python 0.18.0__tar.gz → 0.20.0__tar.gz

{lora_python-0.18.0 → lora_python-0.20.0}/Cargo.lock

@@ -168,7 +168,7 @@ version = "0.72.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "cexpr",
  "clang-sys",
  "itertools",
@@ -180,6 +180,12 @@ dependencies = [
  "syn",
 ]
 
+[[package]]
+name = "bitflags"
+version = "1.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
+
 [[package]]
 name = "bitflags"
 version = "2.11.1"
@@ -498,6 +504,37 @@ dependencies = [
  "syn",
 ]
 
+[[package]]
+name = "defmt"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e2953bfe4f93bbd20cc71198842756f77d161884c99ebbabc41d80231ded88d1"
+dependencies = [
+ "bitflags 1.3.2",
+ "defmt-macros",
+]
+
+[[package]]
+name = "defmt-macros"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bad9c72e7ca2137e0dc3813245a0d282fd6daad32fd800af018306a9169b5fe8"
+dependencies = [
+ "defmt-parser",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "defmt-parser"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10d60334b3b2e7c9d91ef8150abfb6fa4c1c39ebbcf4a81c2e346aad939fee3e"
+dependencies = [
+ "thiserror",
+]
+
 [[package]]
 name = "digest"
 version = "0.10.7"
@@ -733,6 +770,50 @@ version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
 
+[[package]]
+name = "jiff"
+version = "0.2.37"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ab1baf72f08796de0260609515130699b890ac25f30e610ad894bc5856cafdb"
+dependencies = [
+ "defmt",
+ "jiff-core",
+ "jiff-static",
+ "jiff-tzdb",
+ "log",
+ "portable-atomic",
+ "portable-atomic-util",
+ "serde_core",
+]
+
+[[package]]
+name = "jiff-core"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e52fe76043ccecc9005d2305ebaadf7d7fc0cc89ca6baa10a94d6bc68c7128c"
+dependencies = [
+ "defmt",
+ "log",
+]
+
+[[package]]
+name = "jiff-static"
+version = "0.2.37"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "378268a1116ad67ae6228701118ac9f491d78fda38a40a1f1a9e1348de6f7212"
+dependencies = [
+ "jiff-core",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "jiff-tzdb"
+version = "0.1.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "142bd39932ad231f10513df9ab62661fead8719872150b7ad02a2df79f4e141e"
+
 [[package]]
 name = "js-sys"
 version = "0.3.77"
@@ -773,7 +854,7 @@ checksum = "5e5032e24019045c762d3c0f28f5b6b8bbf38563a65908389bf7978758920897"
 
 [[package]]
 name = "lora-analyzer"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "lora-ast",
  "lora-builtins-meta",
@@ -784,14 +865,14 @@ dependencies = [
 
 [[package]]
 name = "lora-ast"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "smallvec 2.0.0-alpha.12",
 ]
 
 [[package]]
 name = "lora-binding-buffer"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "lora-database",
  "lora-store",
@@ -799,11 +880,11 @@ dependencies = [
 
 [[package]]
 name = "lora-builtins-meta"
-version = "0.18.0"
+version = "0.20.0"
 
 [[package]]
 name = "lora-compiler"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "lora-analyzer",
  "lora-ast",
@@ -812,7 +893,7 @@ dependencies = [
 
 [[package]]
 name = "lora-database"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
  "chacha20poly1305",
@@ -837,7 +918,7 @@ dependencies = [
 
 [[package]]
 name = "lora-executor"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "blake3",
  "crc32fast",
@@ -860,7 +941,7 @@ dependencies = [
 
 [[package]]
 name = "lora-ffi"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
  "lora-binding-buffer",
@@ -872,7 +953,7 @@ dependencies = [
 
 [[package]]
 name = "lora-io"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "lora-executor",
  "lora-store",
@@ -883,7 +964,7 @@ dependencies = [
 
 [[package]]
 name = "lora-node"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
  "lora-binding-buffer",
@@ -898,7 +979,7 @@ dependencies = [
 
 [[package]]
 name = "lora-parser"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "lora-ast",
  "pest",
@@ -909,9 +990,10 @@ dependencies = [
 
 [[package]]
 name = "lora-python"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
+ "lora-binding-buffer",
  "lora-database",
  "lora-store",
  "pyo3",
@@ -921,7 +1003,7 @@ dependencies = [
 
 [[package]]
 name = "lora-query-wasm"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "console_error_panic_hook",
  "js-sys",
@@ -935,7 +1017,7 @@ dependencies = [
 
 [[package]]
 name = "lora-server"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
  "axum",
@@ -950,7 +1032,7 @@ dependencies = [
 
 [[package]]
 name = "lora-snapshot"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "argon2",
  "blake3",
@@ -965,9 +1047,10 @@ dependencies = [
 
 [[package]]
 name = "lora-store"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "crc32fast",
+ "jiff",
  "js-sys",
  "lora-ast",
  "serde",
@@ -979,7 +1062,7 @@ dependencies = [
 
 [[package]]
 name = "lora-wal"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "crc32fast",
  "lora-store",
@@ -989,7 +1072,7 @@ dependencies = [
 
 [[package]]
 name = "lora-wasm"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
  "console_error_panic_hook",
@@ -1005,7 +1088,7 @@ dependencies = [
 
 [[package]]
 name = "lora_ruby"
-version = "0.18.0"
+version = "0.20.0"
 dependencies = [
  "anyhow",
  "lora-database",
@@ -1100,7 +1183,7 @@ version = "2.16.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "55740c4ae1d8696773c78fdafd5d0e5fe9bc9f1b071c7ba493ba5c413a9184f3"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "ctor",
  "napi-derive",
  "napi-sys",
@@ -1317,6 +1400,15 @@ version = "1.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
 
+[[package]]
+name = "portable-atomic-util"
+version = "0.2.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10ab3eb7f3becc3a1cbc4f2c6f20267996cfc1a6467a873763411b136a122715"
+dependencies = [
+ "portable-atomic",
+]
+
 [[package]]
 name = "proc-macro2"
 version = "1.0.106"

{lora_python-0.18.0 → lora_python-0.20.0}/Cargo.toml

@@ -1,10 +1,10 @@
 [workspace]
-members = ["crates/lora-ast", "crates/lora-parser", "crates/lora-builtins-meta", "crates/lora-analyzer", "crates/lora-compiler", "crates/lora-store", "crates/lora-snapshot", "crates/lora-io", "crates/lora-wal", "crates/lora-executor", "crates/lora-database", "crates/bindings/lora-python"]
+members = ["crates/lora-ast", "crates/lora-parser", "crates/lora-builtins-meta", "crates/lora-analyzer", "crates/lora-compiler", "crates/lora-store", "crates/lora-snapshot", "crates/lora-io", "crates/lora-wal", "crates/lora-executor", "crates/lora-database", "crates/bindings/lora-binding-buffer", "crates/bindings/lora-python"]
 resolver = "2"
 
 [workspace.package]
 edition = "2021"
-version = "0.18.0"
+version = "0.20.0"
 license = "BUSL-1.1"
 authors = ["LoraDB, Inc."]
 repository = "https://github.com/lora-db/lora"
@@ -15,18 +15,18 @@ rust-version = "1.87"
 # Internal crates — versions are kept in lockstep with [workspace.package].version
 # by `scripts/sync-versions.mjs`. Both `path` and `version` are set so that
 # `cargo publish` works (crates.io cannot resolve path-only deps).
-lora-ast = { path = "crates/lora-ast", version = "=0.18.0" }
-lora-parser = { path = "crates/lora-parser", version = "=0.18.0" }
-lora-builtins-meta = { path = "crates/lora-builtins-meta", version = "=0.18.0" }
-lora-analyzer = { path = "crates/lora-analyzer", version = "=0.18.0" }
-lora-compiler = { path = "crates/lora-compiler", version = "=0.18.0" }
-lora-store = { path = "crates/lora-store", version = "=0.18.0" }
-lora-snapshot = { path = "crates/lora-snapshot", version = "=0.18.0", default-features = false }
-lora-io = { path = "crates/lora-io", version = "=0.18.0" }
-lora-wal = { path = "crates/lora-wal", version = "=0.18.0" }
-lora-executor = { path = "crates/lora-executor", version = "=0.18.0", default-features = false }
-lora-database = { path = "crates/lora-database", version = "=0.18.0" }
-lora-binding-buffer = { path = "crates/bindings/lora-binding-buffer", version = "=0.18.0" }
+lora-ast = { path = "crates/lora-ast", version = "=0.20.0" }
+lora-parser = { path = "crates/lora-parser", version = "=0.20.0" }
+lora-builtins-meta = { path = "crates/lora-builtins-meta", version = "=0.20.0" }
+lora-analyzer = { path = "crates/lora-analyzer", version = "=0.20.0" }
+lora-compiler = { path = "crates/lora-compiler", version = "=0.20.0" }
+lora-store = { path = "crates/lora-store", version = "=0.20.0" }
+lora-snapshot = { path = "crates/lora-snapshot", version = "=0.20.0", default-features = false }
+lora-io = { path = "crates/lora-io", version = "=0.20.0" }
+lora-wal = { path = "crates/lora-wal", version = "=0.20.0" }
+lora-executor = { path = "crates/lora-executor", version = "=0.20.0", default-features = false }
+lora-database = { path = "crates/lora-database", version = "=0.20.0" }
+lora-binding-buffer = { path = "crates/bindings/lora-binding-buffer", version = "=0.20.0" }
 
 # External crates.
 anyhow = "1"
@@ -50,5 +50,9 @@ getrandom = "0.2"
 argon2 = "0.5"
 flate2 = "1"
 rayon = "1"
+# Named time zones: the IANA database bundled into the binary (no
+# filesystem access, so it also works on wasm32). Unlicense OR MIT; the tz
+# data itself is public domain. Used only to resolve zones.
+jiff = { version = "0.2.37", default-features = false, features = ["std", "tzdb-bundle-always"] }
 
 web-time = "1"

{lora_python-0.18.0 → lora_python-0.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lora-python
-Version: 0.18.0
+Version: 0.20.0
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -135,6 +135,32 @@ the Python GIL for the duration of engine work, so other coroutines on the
 event loop can progress while a query runs. A dedicated test proves the
 event loop continues ticking during a 2 000-node `MATCH`.
 
+## Concurrency, transactions and streams
+
+Writers serialize on the database's writer lock; readers never wait for
+it. Every call that may wait for the lock (`execute`, `transaction`,
+`clear`, `load_snapshot`, opening a `stream`) waits with the GIL released,
+so the thread holding the lock always keeps running.
+
+- `execute()` and `transaction([...])` take the lock, run, commit and
+  release it within one call on one thread. On `AsyncDatabase` they run on
+  the loop's default executor; a small or saturated executor delays writes
+  but cannot deadlock them, since the writer holding the lock never needs
+  an executor thread to finish.
+- A mutating `stream()` (one whose query writes) holds the writer lock
+  from open until it is exhausted (commit) or closed early (rollback).
+  It runs on a native thread of its own, so a stream can be pulled,
+  closed or garbage-collected on any thread, and may outlive the
+  `Database` it came from. `AsyncDatabase.stream` never waits for the
+  lock on the event loop: a stream that does not get it at once finishes
+  opening on a thread of its own. It pulls one row per iteration step.
+- While your own code holds a mutating stream open, do not wait on
+  another write to the same database from that same thread or coroutine:
+  that write waits for the lock your stream holds. On `AsyncDatabase`,
+  avoid awaiting other database calls inside the loop body of a mutating
+  stream when many writers may be queued on the executor; collect the
+  rows first, or use `transaction([...])`.
+
 ## Typed value model
 
 Same conceptual contract as `lora-node` / `lora-wasm`:

{lora_python-0.18.0 → lora_python-0.20.0}/README.md

@@ -105,6 +105,32 @@ the Python GIL for the duration of engine work, so other coroutines on the
 event loop can progress while a query runs. A dedicated test proves the
 event loop continues ticking during a 2 000-node `MATCH`.
 
+## Concurrency, transactions and streams
+
+Writers serialize on the database's writer lock; readers never wait for
+it. Every call that may wait for the lock (`execute`, `transaction`,
+`clear`, `load_snapshot`, opening a `stream`) waits with the GIL released,
+so the thread holding the lock always keeps running.
+
+- `execute()` and `transaction([...])` take the lock, run, commit and
+  release it within one call on one thread. On `AsyncDatabase` they run on
+  the loop's default executor; a small or saturated executor delays writes
+  but cannot deadlock them, since the writer holding the lock never needs
+  an executor thread to finish.
+- A mutating `stream()` (one whose query writes) holds the writer lock
+  from open until it is exhausted (commit) or closed early (rollback).
+  It runs on a native thread of its own, so a stream can be pulled,
+  closed or garbage-collected on any thread, and may outlive the
+  `Database` it came from. `AsyncDatabase.stream` never waits for the
+  lock on the event loop: a stream that does not get it at once finishes
+  opening on a thread of its own. It pulls one row per iteration step.
+- While your own code holds a mutating stream open, do not wait on
+  another write to the same database from that same thread or coroutine:
+  that write waits for the lock your stream holds. On `AsyncDatabase`,
+  avoid awaiting other database calls inside the loop body of a mutating
+  stream when many writers may be queued on the executor; collect the
+  rows first, or use `transaction([...])`.
+
 ## Typed value model
 
 Same conceptual contract as `lora-node` / `lora-wasm`:

lora_python-0.20.0/crates/bindings/lora-binding-buffer/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "lora-binding-buffer"
+edition.workspace = true
+version.workspace = true
+license.workspace = true
+authors.workspace = true
+publish = false
+description = "Shared binary result-buffer encoder and row-stream helpers used by the Lora bindings."
+
+[dependencies]
+lora-database.workspace = true
+lora-store.workspace = true