philiprehberger-lock_kit 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea17573729655a3a771771a4491e4ad67313ccdd8c1910964efc84e28cc55cd1
-  data.tar.gz: 3d045b798cd8f8b4df88af8127d4fb1ecd30c0ba252a1058fc90095fc4b98b75
+  metadata.gz: fd5f40b2057061170fc5913d9ac238f7070d3fb05025e9f5bffe2e321e3b240b
+  data.tar.gz: ece6023899b7329973758c48b3f7da96937e9cdc700ec4a11f0e572a7f9d4246
 SHA512:
-  metadata.gz: '08161efb6474fd3cc5b04d6896200df0e6c3e638e7eb89e898e2de4e0efee4ab2ac7decf99eea5f472a78c2914bbb1d5e4665e4d80a4fd7d72efdb3d4c942505'
-  data.tar.gz: 1776595c803f9c9285afc8bb6b7fc9f26cf32db45f1067a5f6084d585f741b5c27d6bce6ab2d1824c2db4941991e44bd1c0ac53e71f845e4011ac079b4f5f4af
+  metadata.gz: 1b57abbeb1216f641fbe8d386425df778fd50a9aadc64be51f98df41e3f47409e6886c0bfe588cde71223b73a684c7da5c7e4c14996c30e66f70961d0fd8bec3
+  data.tar.gz: 4e85ef77b8c6c6bdb50f327a8ddf0841f19754e40ec20b1cfa52e69b7b5ef1127cf8426ed4c4f5e4584c2ff3e54bc13ed8905ab6cd5a15b68da83d7925966d81

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-21
+
+### Added
+- `ReadWriteLock#write_locked?` promoted to a public non-blocking query method
+- `ReadWriteLock#stats` returning `{ readers:, write_locked: }` snapshot
+- `LockKit.rw_stats(path)` module-level helper for the same snapshot without an instance
+
 ## [0.4.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -174,6 +174,7 @@ Philiprehberger::LockKit.stale?('/tmp/my_worker.pid')  # => true/false
 | `.expired?(path)` | Check if a lock has expired based on its TTL |
 | `.owner(path)` | Get lock owner metadata (pid, hostname, acquired_at) |
 | `.break!(path, force: false)` | Break a lock (stale only by default, any with force) |
+| `.rw_stats(path)` | Snapshot of a read-write lock as `{ readers:, write_locked: }` |
 
 ### `LockKit::FileLock`
 
@@ -208,6 +209,8 @@ Philiprehberger::LockKit.stale?('/tmp/my_worker.pid')  # => true/false
 | `#acquire_write(timeout: nil)` | Acquire exclusive write lock |
 | `#release_write` | Release the write lock |
 | `#reader_count` | Get current number of active readers |
+| `#write_locked?` | Non-blocking check for an active write lock |
+| `#stats` | Snapshot as `{ readers:, write_locked: }` |
 
 ## Development
 

data/lib/philiprehberger/lock_kit/read_write_lock.rb

@@ -126,8 +126,9 @@ module Philiprehberger
         0
       end
 
-      private
-
+      # Non-blocking check for whether a write lock is currently held.
+      #
+      # @return [Boolean]
       def write_locked?
         return false unless File.exist?(@write_lock_path)
 
@@ -143,6 +144,13 @@ module Philiprehberger
         end
       end
 
+      # Snapshot of the current lock state: readers and writer presence.
+      #
+      # @return [Hash] `{ readers: Integer, write_locked: Boolean }`
+      def stats
+        { readers: reader_count, write_locked: write_locked? }
+      end
+
       def increment_readers
         update_reader_count(1)
       end

data/lib/philiprehberger/lock_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module LockKit
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/lock_kit.rb

@@ -126,6 +126,14 @@ module Philiprehberger
       FileLock.new(path).locked?
     end
 
+    # Snapshot of read-write lock state for `path` as `{ readers:, write_locked: }`.
+    #
+    # @param path [String] base path used with `with_read_lock` / `with_write_lock`
+    # @return [Hash] `{ readers: Integer, write_locked: Boolean }`
+    def self.rw_stats(path)
+      ReadWriteLock.new(path).stats
+    end
+
     # Check if a PID file references a dead process
     #
     # @param pid_file [String] path to the PID file

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-lock_kit
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-16 00:00:00.000000000 Z
+date: 2026-04-21 00:00:00.000000000 Z
 dependencies: []
 description: File locks using flock and PID file locks with stale detection for coordinating
   between processes. Timeout support and automatic cleanup.