lora-ruby 0.3.0-x86_64-linux → 0.4.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1a6d6131a623aa36490db126c7fb93fad1dbed45488d55be429333b080ba80f
-  data.tar.gz: a9ee49a1f084432d669fca32e8a18d73985e92e954749d202f96248532297baa
+  metadata.gz: 56ecc108e6296c299d4c4a88ff9cc6c457e7f4969804a70aad7b411f2c51e4a3
+  data.tar.gz: 9581c66e79f86c057f663e09528238b907f97f13182d412e741fb6ca4216d95c
 SHA512:
-  metadata.gz: 3efb0b9f49aa8f7c7d498d2cb0ee2480f53842f1aeb5374ed68c9b199a990275677f07b0104411f5a6112be1508c9fc9b4fa542479b703951427de404475b8b7
-  data.tar.gz: 8cdd836f9bd0a9bc932c96b549bb3ab106e9e838281b4a250dcd6db65f90b9782007ef975c1ec99c57d8eb99c1031230d893df618afed4c19859b934feee66b6
+  metadata.gz: b5e72d52e5e2dab1b409f2576fbf5905cb1de0a5ba8d5646543f8cec963576bef2dff421d442790165debe93bab2470e6cac3fab6864efdc591e31ebf8c429a7
+  data.tar.gz: 047d5d1da597d45117f56239afc340d8336bd0c4c4609a90f977cf9450d6e5217b80d7741a74b17917b25fc3654b9307718d15c0d44670e65663905e15d804c9

data/README.md

@@ -1,6 +1,6 @@
 # lora-ruby
 
-Ruby bindings for the [Lora](../../README.md) in-memory graph engine.
+Ruby bindings for the [Lora](../../README.md) graph engine.
 Ships a native extension built with [Magnus](https://github.com/matsadler/magnus)
 on top of [`rb-sys`](https://github.com/oxidize-rb/rb-sys) so the Rust
 engine runs in-process — no separate server, no socket hop.
@@ -39,6 +39,16 @@ result["rows"].each do |row|
 end
 ```
 
+Initialization rule:
+
+```ruby
+scratch = LoraRuby::Database.create         # in-memory
+persistent = LoraRuby::Database.create("./app") # persistent: directory string
+```
+
+If you want persistence, pass a directory string to
+`LoraRuby::Database.create(...)` or `LoraRuby::Database.new(...)`.
+
 ### Params
 
 `execute` accepts a second argument — either `nil` or a `Hash` keyed by
@@ -66,8 +76,8 @@ binding's `lora_python.Database` and because it mirrors the
 ## Public API
 
 ```ruby
-LoraRuby::Database.create            # -> Database
-LoraRuby::Database.new               # -> Database  (alias of .create)
+LoraRuby::Database.create(wal_dir = nil)  # -> Database
+LoraRuby::Database.new(wal_dir = nil)     # -> Database  (alias of .create)
 
 db.execute(query, params = nil)       # -> { "columns" => [...], "rows" => [...] }
 db.clear                              # -> nil
@@ -136,6 +146,20 @@ db.execute(
 - `LoraRuby::QueryError` — parse / analyze / execute failure.
 - `LoraRuby::InvalidParamsError` — a parameter value couldn't be mapped.
 
+## Persistence
+
+`LoraRuby::Database.create("./app")` and
+`LoraRuby::Database.new("./app")` open or create a WAL-backed
+persistent database rooted at that directory. Reopening the same path
+replays committed writes before returning the handle.
+
+Call `db.close` before reopening the same WAL directory inside one
+process.
+
+This first Ruby persistence slice intentionally stays small: the
+binding exposes WAL-backed initialization plus the existing snapshot
+APIs, but not checkpoint, truncate, status, or sync-mode controls.
+
 ## Concurrency (GVL release)
 
 `Database#execute` calls `rb_thread_call_without_gvl`, so other Ruby

data/lib/lora_ruby/version.rb

@@ -10,5 +10,5 @@ module LoraRuby
   # Guard against redefinition so re-requiring this file (or loading
   # both paths) doesn't emit a "warning: already initialized constant"
   # when the native extension loads second with the identical value.
-  VERSION = "0.3.0" unless const_defined?(:VERSION)
+  VERSION = "0.4.0" unless const_defined?(:VERSION)
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lora-ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: x86_64-linux
 authors:
 - LoraDB, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-04-24 00:00:00.000000000 Z
+date: 2026-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake