virgodb 0.2.0-x86_64-linux-gnu → 0.3.0-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2c55249e7aad1d1fa30b2e5b0b33faeededd48155b6a1d31cad1d66c86f150f
-  data.tar.gz: e7f80300627403933ea3dcfb0bc3e8e3321caa3b0f0d11309238978fa65915a0
+  metadata.gz: 6141e1a5628b4293f7d63bd3143fe20bcbff6f697df38fc67c1da4c2669369ab
+  data.tar.gz: 7814e9e3a10ba0ce4e5126e492d38410637aa818d21abb4352b6f038fc9b4139
 SHA512:
-  metadata.gz: '00849d11354b21ffa53f665b607aad25114b02f78d296b9b8594016962ea378eb1bdcc905c77d5024e1cf4376b28af183da2c3918d30965bba7f3080547d238e'
-  data.tar.gz: b8190d81fdcd7276cf12ead7c054a10e8e61d6f25daa2f39ad42f2166b8118c917cfe031b26cfbfa6239d420ad4ba5ce8e3e8c14b010028c8e8b019871df4d83
+  metadata.gz: '0468833ba6f07aed2d56ea13ca5d158a523fb64486ec4fa5259c969200f9c4e991fb96a545ad26a78c8531460855c59dcbcc0904be5a8d43f558dd2bb4f27255'
+  data.tar.gz: 475c654f9a604b83c05b0036c4cdffb478c339b05fb794a9cef445b5244584394cef90289bbb57cdc8f7c65a8918fb7a8111e545d9a790c6b375eca454929a47

data/lib/virgodb/table.rb

@@ -101,6 +101,29 @@ module Virgodb
       json && JSON.parse(json)
     end
 
+    # Claims this table's maintenance lease as `holder` for the next
+    # `lease_duration_secs` seconds, locking out the real maintenance
+    # thread (its own claim attempts fail against an unexpired lease the
+    # same way two maintenance threads would contend) -- meant for a
+    # caller like a backup job that needs a window where compaction/vacuum
+    # won't rewrite or delete this table's data directory. Returns `false`
+    # (not an error) if someone else's lease is still active; callers
+    # should retry rather than treat that as failure. Doesn't call `writer`
+    # first (unlike `tombstone` above) -- claiming a lease has nothing to
+    # do with this table's Writer, and a caller like a backup job may never
+    # otherwise touch this table's Writer in this process at all. Not
+    # mutex-guarded, same reasoning as `query`/`maintenance_health` above.
+    def claim_maintenance_lease(holder:, lease_duration_secs:)
+      Virgodb.claim_maintenance_lease(@manifest_path, @sql_table_name, holder.to_s, lease_duration_secs)
+    end
+
+    # Releases a lease claimed via `claim_maintenance_lease` above, so the
+    # real maintenance thread can resume on its next poll rather than
+    # waiting out the full lease duration.
+    def release_maintenance_lease(holder:)
+      Virgodb.release_maintenance_lease(@manifest_path, @sql_table_name, holder.to_s)
+    end
+
     private
 
     def writer

data/lib/virgodb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Virgodb
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: virgodb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: x86_64-linux-gnu
 authors:
 - virgodb
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-23 00:00:00.000000000 Z
+date: 2026-09-02 00:00:00.000000000 Z
 dependencies: []
 description: |
   Embeds virgodb (an OLAP engine backed by Parquet + DataFusion) directly into a Ruby process