philiprehberger-task_queue 0.2.8 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f754b8edbc5ff436a9f86017218b9953e38fa91149079a75099a939cb68d0a00
-  data.tar.gz: 21bca679e41f7a16f03aaf12aa550728b22d22258432692ac25fdffdec3dfaf5
+  metadata.gz: 2524cd95e75d5fef01076f0bb4895a3d3aceeed233a2b68eabc596c7a731ebfa
+  data.tar.gz: 7df5392a5796de69bf086cc47484cb5481f1e131099d3994062e5e3c308d4b06
 SHA512:
-  metadata.gz: 6b39b25e722d3d7899b856bb402c6ab6334a05b57163cd0dcecc63ed85467fc3126c0ae2147737db5d90c22c01a1e1528249ee1773f7cdd15a82669007f48bf7
-  data.tar.gz: 5fb4e00d377baaeb159c5357fa73ef3de43f98adfabd495f523d92c1e9762911bff5dcb72562cab1d74212d198b77b67edbd68744603e4ef4cd5f71b0b69e073
+  metadata.gz: 60adcdcd0b47caba95f1eb03c8be5e340e62aaf9fe2d9ed5ac85a702e1ac89d95e65c810a245bd5d9d0ddbd7fcbc68c493c46497a53298fe7721f90240107582
+  data.tar.gz: 1657f7b9c9b358a58ca2aae35896374e5193a295e753d47054f662233237fef68148175d8e7e40a050bf102fb68f32cf790827f79f84b9450fea7d0be75ab8ac

data/CHANGELOG.md

@@ -7,6 +7,29 @@ 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
+- Standardize README badges, support section, and license format
+
+## [0.2.9] - 2026-03-26
+
+### Changed
+- Add Sponsor badge to README
+- Fix License section format
+- Sync gemspec summary with README
+
+
 ## [0.2.8] - 2026-03-24
 
 ### Fixed

data/README.md

@@ -2,7 +2,7 @@
 
 [![Tests](https://github.com/philiprehberger/rb-task-queue/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/rb-task-queue/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-task_queue.svg)](https://rubygems.org/gems/philiprehberger-task_queue)
-[![License](https://img.shields.io/github/license/philiprehberger/rb-task-queue)](LICENSE)
+[![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-task-queue)](https://github.com/philiprehberger/rb-task-queue/commits/main)
 
 In-process async job queue with concurrency control
 
@@ -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,11 +159,11 @@ 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 |
 
-
 ## Development
 
 ```bash
@@ -153,6 +172,24 @@ bundle exec rspec
 bundle exec rubocop
 ```
 
+## Support
+
+If you find this project useful:
+
+⭐ [Star the repo](https://github.com/philiprehberger/rb-task-queue)
+
+🐛 [Report issues](https://github.com/philiprehberger/rb-task-queue/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+
+💡 [Suggest features](https://github.com/philiprehberger/rb-task-queue/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+
+❤️ [Sponsor development](https://github.com/sponsors/philiprehberger)
+
+🌐 [All Open Source Projects](https://philiprehberger.com/open-source-packages)
+
+💻 [GitHub Profile](https://github.com/philiprehberger)
+
+🔗 [LinkedIn Profile](https://www.linkedin.com/in/philiprehberger)
+
 ## License
 
-MIT
+[MIT](LICENSE)

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.8'
+    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.8
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-25 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
@@ -52,5 +52,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: In-process async job queue with concurrency control
+summary: In-process async job queue with concurrency control for Ruby
 test_files: []