lora-ruby 0.5.6-x86_64-linux → 0.6.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 155820b5ff90f8828c11df7dd6ce3950b0601e2e374ea8353af9222db282c6f3
-  data.tar.gz: d856048cb887c4cbefac9bbe7f4e72af2fb22eae82c6488d5140edd22fe952b9
+  metadata.gz: d16b151caa8498f6f7f535201b024ae763a77409fe6e00cdfefb73ecdc4134bf
+  data.tar.gz: b77d4d4c60e6f6e4d81ea49d6f66bc11e8373f4efd918599bc99cabb1c733425
 SHA512:
-  metadata.gz: 06b481a3cdc376c01bdb2e8933974d6c736a48963a81ed78107f1547efadc3634983471fe4e8da8d07089f42715c92a8c0d2a4f854be78ede0c01b605e74d149
-  data.tar.gz: 1a55006ecb781a0ac2ecdd37a75c89eb9d7571a31f7836d5d78b94bedb7e4fa9ce8406df609b77f00f9e61a2cae289c13b4515b0f59bfe49b01a8a5ad33fd669
+  metadata.gz: 0b72af87acb141f9c816ceb921dde8d44857699e41241ea966d8b1d67e08e9d5bf681321d0fa40058f42e4a23e70328f55655285e5d8e32fcb1f2e9791b88f23
+  data.tar.gz: a5111d6e8cc41ad52ee2a06bd8f12512ce4ba9eb49a7de600980cc159608da8adca3c8c72c3a9d018c197e5d56d4bb47dbb23b82e7aa9ffb6281d17c629e397f

data/README.md

@@ -76,8 +76,9 @@ binding's `lora_python.Database` and because it mirrors the
 ## Public API
 
 ```ruby
-LoraRuby::Database.create(wal_dir = nil)  # -> Database
-LoraRuby::Database.new(wal_dir = nil)     # -> Database  (alias of .create)
+LoraRuby::Database.create(database_name = nil, options = nil)  # -> Database
+LoraRuby::Database.new(database_name = nil, options = nil)     # -> Database
+LoraRuby::Database.open_wal(wal_dir, options = nil)            # -> Database
 
 db.execute(query, params = nil)       # -> { "columns" => [...], "rows" => [...] }
 db.clear                              # -> nil
@@ -156,9 +157,19 @@ replays committed writes before returning the handle.
 Call `db.close` before reopening the same archive inside one
 process.
 
-This first Ruby persistence slice intentionally stays small: the
-binding exposes archive-backed initialization plus the existing snapshot
-APIs, but not checkpoint, truncate, status, or sync-mode controls.
+For explicit WAL directories with managed snapshots, use `open_wal`:
+
+```ruby
+db = LoraRuby::Database.open_wal(
+  "./data/wal",
+  snapshot_dir: "./data/snapshots",
+  snapshot_every_commits: 1000,
+  snapshot_keep_old: 2,
+)
+```
+
+`snapshot_options` accepts the same compression/encryption options as
+`save_snapshot`.
 
 ## Concurrency (GVL release)
 

data/lib/lora_ruby/types.rb

@@ -7,7 +7,7 @@ module LoraRuby
   # - Scalars pass through as Ruby natives (`nil`, `true`, `false`,
   #   `Integer`, `Float`, `String`).
   # - Lists and maps come back as `Array` / `Hash` (string keys).
-  # - Graph, temporal, and spatial values come back as plain `Hash`es
+  # - Graph, temporal, spatial, vector, and binary values come back as plain `Hash`es
   #   with a `"kind"` discriminator.
   #
   # If you want to narrow a value explicitly, use the `node?` / `point?`
@@ -56,6 +56,21 @@ module LoraRuby
       }
     end
 
+    # ------------------------------------------------------------------
+    # Binary / blob constructor — segmented bytes. The native extension
+    # accepts each segment as a Ruby String and preserves segment
+    # boundaries in WAL/snapshot storage.
+    # ------------------------------------------------------------------
+
+    def binary(segments)
+      copied = segments.map { |segment| segment.b.dup }
+      {
+        "kind"     => "binary",
+        "length"   => copied.sum(&:bytesize),
+        "segments" => copied,
+      }
+    end
+
     # ------------------------------------------------------------------
     # Spatial constructors — mirrors lora_python.cartesian / wgs84.
     # `cartesian(1, 2)` returns a 2D cartesian point; use `cartesian_3d`
@@ -122,6 +137,7 @@ module LoraRuby
     def path?(v)         = tagged?(v, "path")
     def point?(v)        = tagged?(v, "point")
     def vector?(v)       = tagged?(v, "vector")
+    def binary?(v)       = tagged?(v, "binary")
 
     def temporal?(v)
       return false unless v.is_a?(Hash)

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.5.6" unless const_defined?(:VERSION)
+  VERSION = "0.6.0" unless const_defined?(:VERSION)
 end

data/lib/lora_ruby.rb

@@ -32,8 +32,8 @@ module LoraRuby
   %i[
     date time localtime datetime localdatetime duration
     cartesian cartesian_3d wgs84 wgs84_3d
-    vector
-    node? relationship? path? point? temporal? vector?
+    vector binary
+    node? relationship? path? point? temporal? vector? binary?
   ].each do |m|
     define_singleton_method(m) do |*args, **kwargs|
       if kwargs.empty?

metadata

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