lora-ruby 0.5.6-aarch64-linux → 0.6.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 757c503dba197deecf347eb88a9d9c13e0da176edcaf296879363126107cd4a1
-  data.tar.gz: a3f4e8bfb3b947a536316022fc85d65fb23158dd049fbbc2e7dc436852b3cc42
+  metadata.gz: 625e87d729f6f0fe8cd122e0a87a4d2908445f9d5e4880177e2113e980d7a790
+  data.tar.gz: a3f3a29409f5d880a1f28a4e495a19414e2eb863bef9f59969485e4f249b6c16
 SHA512:
-  metadata.gz: 0a08ba5ff60f2180aa0c006788241365eaf6421c47b7f114fadcf8715fe2af6924b67a541e61fd98ec53e1358384f16544d32ef0fda3f6a3616d2e48549265b0
-  data.tar.gz: 631c4c3ae4a606d3bba81d1a27d3afa1dd8038caee14d5d5c2ea3c480fc0bb72bce00c76ff51f3f337e962e41fef284a1b79f44d3ad86287b9c925864dabfb58
+  metadata.gz: 9041a08d3fec37fd16976e1ff2baa5f11e46cae0f3a2548656538ef845641be5c6cfdc0a8c1f4f806ec3974e4085d881e71ebf2cc901719c92dfb60e6b947f76
+  data.tar.gz: f2d582b1624f6293ecb8a72b175c80d1e9243b6f2f8866c313eb12675b5777e4e19596b98795ff51c0455147246598a56e10a27ba87f60b754e47b9e23990a88

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: aarch64-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