philiprehberger-task_queue 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f4e9b0ae4aaef03d903590f90278ed497bf0a4a39b76ee2a7f982d2c949e6c8
-  data.tar.gz: 5aa3e3eed6e165c88535e59bb7309d98e6790fbcd055faaf16ecff8daef7731e
+  metadata.gz: 9e95b1aa86d2dd6d24bffa365e89a42a94b3e667da82884145503f3f40dcd27c
+  data.tar.gz: ca709893092da51f536a6cf209b986f6e085fea9b2cd391f9d705fbc3ab7267c
 SHA512:
-  metadata.gz: dea4e36934d59796510506c3ece4af9bbbe1bf0307eeaa8c79fc6421f187b700b79c4b61d439e927e9720ee483f75cf0b6cedcd84e642a03a1352814efbdcacb
-  data.tar.gz: b7aafb9cccc93e6e753720c194300f6caa2b7407c080949fea77a985ab4d40ac3c8033535cc3485e124359bfc75ad6f1d3d6d5b40dec9cac5560f68e14c379af
+  metadata.gz: 998d63c445066bb5b913b9b652121775b620d30175b6f354cc22d071eec98f9818f6bac9ca79f1b02185da57d5401ac44327ca459e588fdbe3fc7ea293bd1e91
+  data.tar.gz: 56eeafdb0b968a163a69b709eafaf1ca934e543eaeb45d532a4f730333bca83644f3ad808327b1c071056d9870a2cf4b0018b44849a4bd298c256002b58acd33

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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

@@ -140,6 +140,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 +213,7 @@ 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 |
 
 ## Development
 

data/lib/philiprehberger/task_queue/queue.rb

@@ -100,6 +100,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.5.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.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight, zero-dependency, thread-safe in-process async job queue
   with configurable concurrency for Ruby applications.