philiprehberger-task_queue 0.2.10 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0e8b37d7bad85dce1fa4281f41df74991b9e6362d6d5bf7e1cddf1dc0612f9a
-  data.tar.gz: 54a8725dea3cad2f9b8c8ec711dfa1c21522683d27d9d3bb84861d270a5b3f4a
+  metadata.gz: 2524cd95e75d5fef01076f0bb4895a3d3aceeed233a2b68eabc596c7a731ebfa
+  data.tar.gz: 7df5392a5796de69bf086cc47484cb5481f1e131099d3994062e5e3c308d4b06
 SHA512:
-  metadata.gz: ce894a8d984f95d2161d870ada0e0aef8f394cbbbd9f204173e5133eaa52acc0d6d59492dc4b4886fbcaa7461a360b588ba2e25fef908575a2f523aae216f610
-  data.tar.gz: f945b9c98cf3e8f13572c07dd8709ca040f340a66ba64a57d2552f6c219b9f74b0ee59293ef7859d1670f268dbcf5a936198058262e8f6fb40ca028e135e8643
+  metadata.gz: 60adcdcd0b47caba95f1eb03c8be5e340e62aaf9fe2d9ed5ac85a702e1ac89d95e65c810a245bd5d9d0ddbd7fcbc68c493c46497a53298fe7721f90240107582
+  data.tar.gz: 1657f7b9c9b358a58ca2aae35896374e5193a295e753d47054f662233237fef68148175d8e7e40a050bf102fb68f32cf790827f79f84b9450fea7d0be75ab8ac

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-04
+
+### Added
+- `on_complete(&block)` callback that fires after each successful task completion with the task result
+
+## [0.2.11] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.2.10] - 2026-03-31
 
 ### Changed

data/README.md

@@ -67,6 +67,25 @@ puts queue.stats
 # => { completed: 0, failed: 2, pending: 0 }
 ```
 
+### Completion callback
+
+Register a callback to run after each successful task completion. The callback receives the return value of the task.
+
+```ruby
+queue = Philiprehberger::TaskQueue.new(concurrency: 2)
+
+queue.on_complete do |result|
+  puts "Task finished with: #{result}"
+end
+
+queue.push { 42 }
+queue.push { { status: "ok" } }
+
+queue.drain(timeout: 5)
+# Task finished with: 42
+# Task finished with: {:status=>"ok"}
+```
+
 ### Statistics
 
 `stats` returns a snapshot of completed, failed, and pending counts. All counters are thread-safe and updated atomically after each task finishes.
@@ -140,6 +159,7 @@ queue.shutdown(timeout: 5)
 | `#size` | _(none)_ | `Integer` | Number of pending (not yet started) 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 |
 | `#on_error(&block)` | `&block` — callback receiving `(exception, task)` | `self` | Register an error callback invoked when a task raises a `StandardError` |
 | `#stats` | _(none)_ | `Hash` | Returns `{ completed:, failed:, pending: }` with Integer counts |
 | `#drain(timeout:)` | `timeout` — seconds to wait (Numeric, default `30`) | `nil` | Block until all pending and in-flight tasks complete without shutting down |

data/lib/philiprehberger/task_queue/queue.rb

@@ -20,6 +20,7 @@ module Philiprehberger
         @running = true
         @started = false
         @error_handler = nil
+        @complete_handler = nil
         @stats = { completed: 0, failed: 0, in_flight: 0 }
       end
 
@@ -34,6 +35,17 @@ module Philiprehberger
         self
       end
 
+      # Register a callback invoked after each successful task completion.
+      #
+      # The callback receives the return value of the completed task.
+      #
+      # @yield [result] called on task success
+      # @return [self]
+      def on_complete(&block)
+        @mutex.synchronize { @complete_handler = block }
+        self
+      end
+
       # Return statistics about processed tasks.
       #
       # @return [Hash{Symbol => Integer}] counts for :completed, :failed, :pending
@@ -133,7 +145,8 @@ module Philiprehberger
         @concurrency.times do
           @workers << Worker.new(
             @tasks, @mutex, @condition,
-            context: { stats: @stats, error_handler: @error_handler, drain_condition: @drain_condition }
+            context: { stats: @stats, error_handler: @error_handler,
+                       complete_handler: @complete_handler, drain_condition: @drain_condition }
           )
         end
         @started = true

data/lib/philiprehberger/task_queue/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module TaskQueue
-    VERSION = '0.2.10'
+    VERSION = '0.3.0'
   end
 end

data/lib/philiprehberger/task_queue/worker.rb

@@ -12,6 +12,7 @@ module Philiprehberger
         @condition = condition
         @stats = context[:stats]
         @error_handler = context[:error_handler]
+        @complete_handler = context[:complete_handler]
         @drain_condition = context[:drain_condition]
         @running = true
         @thread = Thread.new { run }
@@ -48,17 +49,18 @@ module Philiprehberger
       end
 
       def execute(task)
-        task.call
-        record_completion
+        result = task.call
+        record_completion(result)
       rescue StandardError => e
         record_failure(e, task)
       end
 
-      def record_completion
+      def record_completion(result)
         @mutex.synchronize do
           @stats[:completed] += 1
           @stats[:in_flight] -= 1
         end
+        @complete_handler&.call(result)
       end
 
       def record_failure(error, task)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-task_queue
 version: !ruby/object:Gem::Version
-  version: 0.2.10
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-05 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight, zero-dependency, thread-safe in-process async job queue
   with configurable concurrency for Ruby applications.
@@ -25,11 +25,11 @@ files:
 - lib/philiprehberger/task_queue/queue.rb
 - lib/philiprehberger/task_queue/version.rb
 - lib/philiprehberger/task_queue/worker.rb
-homepage: https://github.com/philiprehberger/rb-task-queue
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-task_queue
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-task-queue
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-task_queue
   source_code_uri: https://github.com/philiprehberger/rb-task-queue
   changelog_uri: https://github.com/philiprehberger/rb-task-queue/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-task-queue/issues