virgodb 0.2.0-x86_64-linux-gnu → 0.4.0-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2c55249e7aad1d1fa30b2e5b0b33faeededd48155b6a1d31cad1d66c86f150f
-  data.tar.gz: e7f80300627403933ea3dcfb0bc3e8e3321caa3b0f0d11309238978fa65915a0
+  metadata.gz: 7f2b2b64a9eb427278ad164d7d0e6d1fffe25153a474037ca9955c320e9973d0
+  data.tar.gz: 15a4fafc1e21e3ad7db4cef580e2f90eef042cadc85f1e292eecdc3984130c08
 SHA512:
-  metadata.gz: '00849d11354b21ffa53f665b607aad25114b02f78d296b9b8594016962ea378eb1bdcc905c77d5024e1cf4376b28af183da2c3918d30965bba7f3080547d238e'
-  data.tar.gz: b8190d81fdcd7276cf12ead7c054a10e8e61d6f25daa2f39ad42f2166b8118c917cfe031b26cfbfa6239d420ad4ba5ce8e3e8c14b010028c8e8b019871df4d83
+  metadata.gz: fff30689328b67c225d5ffb0a3596052f16f8d256125a819f33168cc7af2679e5f540f6c6052263e99d16a682fedd7455a6b3f63c70b63a1b6a6be65b233c0bd
+  data.tar.gz: b12f81151f9b5f0ccfd900bb63fc2d2038f023512fced52e812dc521514c09ef4e8571414c26999f6482715ccb62d53c58c0730c05fc9745eeab464db270ce50

data/lib/virgodb/table.rb

@@ -101,6 +101,41 @@ 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
+
+    # Extends a lease claimed via `claim_maintenance_lease` above without
+    # needing it to expire first -- calling `claim_maintenance_lease` again
+    # on a lease you already validly hold is a guaranteed no-op, not a
+    # renewal (see `Manifest::renew_maintenance_lease`'s own doc comment).
+    # For a caller whose work under the lease might run longer than one
+    # fixed grant. Returns `false` (not an error) if `holder` no longer
+    # matches the current holder -- treat that as "lost the lease," not
+    # something to retry blindly.
+    def renew_maintenance_lease(holder:, lease_duration_secs:)
+      Virgodb.renew_maintenance_lease(@manifest_path, @sql_table_name, holder.to_s, lease_duration_secs)
+    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.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: virgodb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.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