philiprehberger-task_queue 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e95b1aa86d2dd6d24bffa365e89a42a94b3e667da82884145503f3f40dcd27c
-  data.tar.gz: ca709893092da51f536a6cf209b986f6e085fea9b2cd391f9d705fbc3ab7267c
+  metadata.gz: e39241a1442d74c80e1e1588468bd8ad95353479568b0be9ccf31084bd755585
+  data.tar.gz: b00310624003336ce97b36fe9931f4a11e5f4081814c3c30d2364c4f4619c527
 SHA512:
-  metadata.gz: 998d63c445066bb5b913b9b652121775b620d30175b6f354cc22d071eec98f9818f6bac9ca79f1b02185da57d5401ac44327ca459e588fdbe3fc7ea293bd1e91
-  data.tar.gz: 56eeafdb0b968a163a69b709eafaf1ca934e543eaeb45d532a4f730333bca83644f3ad808327b1c071056d9870a2cf4b0018b44849a4bd298c256002b58acd33
+  metadata.gz: 2c6ebf43fccdbbd00158f78859cdd79e4767e4148a82a55d81179a4be71b9346274c8ab419af1daf0a58ebd2214080bbc9b5d7b77a19267d2beefbe54b57fbf5
+  data.tar.gz: a08587cc8f79fdfcb11e3076d411225098596ad64a0b17e0c3f86e55ec142582a5018dc6832b622c77ff0bcc2bc97b55116ee3cd2384fe17bbce1fe6d4d6011c

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-05-13
+
+### Added
+- `Queue#busy?` — predicate returning `true` when there are pending tasks or in-flight tasks; convenient inverse of "idle" for callers polling without going through `#stats`.
+
+## [0.6.0] - 2026-05-07
+
+### Added
+- `Queue#concurrency` — read-only accessor for the maximum number of concurrent worker threads.
+
 ## [0.5.0] - 2026-04-19
 
 ### Added

data/README.md

@@ -97,14 +97,16 @@ queue = Philiprehberger::TaskQueue.new(concurrency: 4)
 queue.drain(timeout: 10)
 
 stats = queue.stats
-puts "Completed: #{stats[:completed]}"
-puts "Failed:    #{stats[:failed]}"
-puts "Pending:   #{stats[:pending]}"
-puts "In-flight: #{stats[:in_flight]}"
-# Completed: 19
-# Failed:    1
-# Pending:   0
-# In-flight: 0
+puts "Completed:   #{stats[:completed]}"
+puts "Failed:      #{stats[:failed]}"
+puts "Pending:     #{stats[:pending]}"
+puts "In-flight:   #{stats[:in_flight]}"
+puts "Concurrency: #{queue.concurrency}"
+# Completed:   19
+# Failed:      1
+# Pending:     0
+# In-flight:   0
+# Concurrency: 4
 ```
 
 ### Pause and resume
@@ -203,6 +205,7 @@ queue.shutdown(timeout: 5)
 | `#<<(callable)` | `callable` — any object responding to `#call` | `self` | Alias for `#push`; convenient for lambdas and procs |
 | `#size` | _(none)_ | `Integer` | Number of pending (not yet started) tasks |
 | `#empty?` | _(none)_ | `Boolean` | Whether there are no pending tasks waiting to be started |
+| `#busy?` | _(none)_ | `Boolean` | Whether the queue has any pending tasks or in-flight tasks |
 | `#running?` | _(none)_ | `Boolean` | Whether the queue is accepting new tasks |
 | `#shutdown(timeout:)` | `timeout` — seconds to wait for workers (Numeric, default `30`) | `nil` | Signal workers to stop, drain remaining tasks, join threads up to `timeout` seconds |
 | `#on_complete(&block)` | `&block` — callback receiving `(result)` | `self` | Register a callback invoked after each successful task completion with the task's return value |
@@ -214,6 +217,7 @@ queue.shutdown(timeout: 5)
 | `#paused?` | _(none)_ | `Boolean` | Whether the queue is currently paused |
 | `#clear` | _(none)_ | `Integer` | Remove all pending tasks and return the number cleared |
 | `#stats_reset!` | _(none)_ | `self` | Atomically zero the `completed` and `failed` counters while leaving pending, in-flight, workers, and callbacks untouched |
+| `#concurrency` | _(none)_ | `Integer` | Returns the configured maximum number of concurrent worker threads |
 
 ## Development
 

data/lib/philiprehberger/task_queue/queue.rb

@@ -9,6 +9,9 @@ module Philiprehberger
     # Tasks are enqueued as blocks or callable objects and executed by a pool of
     # worker threads. The queue is fully thread-safe.
     class Queue
+      # @return [Integer] the maximum number of concurrent worker threads
+      attr_reader :concurrency
+
       # @param concurrency [Integer] maximum number of concurrent worker threads
       def initialize(concurrency: 4)
         @concurrency = concurrency
@@ -170,6 +173,16 @@ module Philiprehberger
         @mutex.synchronize { @tasks.empty? }
       end
 
+      # Whether the queue has any pending tasks or any in-flight tasks.
+      #
+      # Convenient inverse of "idle" for callers polling without going
+      # through +stats+. Equivalent to: +!empty? || in_flight > 0+.
+      #
+      # @return [Boolean]
+      def busy?
+        @mutex.synchronize { !@tasks.empty? || @stats[:in_flight].positive? }
+      end
+
       # Whether the queue is accepting new tasks.
       #
       # @return [Boolean]

data/lib/philiprehberger/task_queue/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module TaskQueue
-    VERSION = '0.5.0'
+    VERSION = '0.7.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-task_queue
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-20 00:00:00.000000000 Z
+date: 2026-05-14 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight, zero-dependency, thread-safe in-process async job queue
   with configurable concurrency for Ruby applications.