philiprehberger-task_queue 0.4.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f4e9b0ae4aaef03d903590f90278ed497bf0a4a39b76ee2a7f982d2c949e6c8
-  data.tar.gz: 5aa3e3eed6e165c88535e59bb7309d98e6790fbcd055faaf16ecff8daef7731e
+  metadata.gz: 4729f65b6cd35decf68be8f1850b13609d87457fa049d8914f74ade8d89f9193
+  data.tar.gz: 5e26c336765fbf7e73c2bdd132a2791bbf60d0191b8748f90768cb934e4a449f
 SHA512:
-  metadata.gz: dea4e36934d59796510506c3ece4af9bbbe1bf0307eeaa8c79fc6421f187b700b79c4b61d439e927e9720ee483f75cf0b6cedcd84e642a03a1352814efbdcacb
-  data.tar.gz: b7aafb9cccc93e6e753720c194300f6caa2b7407c080949fea77a985ab4d40ac3c8033535cc3485e124359bfc75ad6f1d3d6d5b40dec9cac5560f68e14c379af
+  metadata.gz: f68ed0d8be0ead8665425550efbd32d467def35234bff29875d328cabf2ab722da88789ac3a97c60b0cc29a1c299b3c015b9eea0d65ace89677592f12fd2c8d7
+  data.tar.gz: 79d4ead9724546b60ee902815899b79f573cdd6a09a1d51eb93a78dc5062355827b76b2542b1a2150db4461fa8ee459aefdf2f1374816c576fb228dd5ae41b45

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- `Queue#stats_reset!` — atomically zero the `completed` and `failed` counters while leaving pending, in-flight, workers, and callbacks untouched; useful for per-interval metrics
+
 ## [0.4.2] - 2026-04-08
 
 ### Changed

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
@@ -140,6 +142,16 @@ puts "Cleared #{cleared} tasks"
 queue.shutdown(timeout: 5)
 ```
 
+### Reset counters
+
+```ruby
+queue = Philiprehberger::TaskQueue.new(concurrency: 4)
+10.times { queue.push { do_work } }
+queue.drain
+queue.stats_reset!
+queue.stats[:completed] # => 0
+```
+
 ### FIFO ordering guarantees
 
 Tasks are stored in an internal array and dequeued in FIFO order. When `concurrency` is `1`, tasks execute strictly in the order they were pushed. With higher concurrency, dequeue order is still FIFO but tasks may complete out of order depending on individual execution time.
@@ -203,6 +215,8 @@ queue.shutdown(timeout: 5)
 | `#resume` | _(none)_ | `self` | Resume a paused queue, waking workers to continue processing |
 | `#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
@@ -100,6 +103,21 @@ module Philiprehberger
         end
       end
 
+      # Atomically zero the +completed+ and +failed+ counters.
+      #
+      # Leaves +pending+, +in_flight+, worker threads, and registered callbacks
+      # untouched. Useful for resetting metrics between reporting intervals
+      # without shutting down the pool.
+      #
+      # @return [self]
+      def stats_reset!
+        @mutex.synchronize do
+          @stats[:completed] = 0
+          @stats[:failed] = 0
+        end
+        self
+      end
+
       # Block until all pending tasks are complete without shutting down.
       #
       # @param timeout [Numeric] seconds to wait before returning

data/lib/philiprehberger/task_queue/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module TaskQueue
-    VERSION = '0.4.2'
+    VERSION = '0.6.0'
   end
 end

metadata

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