philiprehberger-task_queue 0.6.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4729f65b6cd35decf68be8f1850b13609d87457fa049d8914f74ade8d89f9193
-  data.tar.gz: 5e26c336765fbf7e73c2bdd132a2791bbf60d0191b8748f90768cb934e4a449f
+  metadata.gz: 5bd60112f6cfee945ef38be345d06ee98eb67f8cf41c58130d878806512f6459
+  data.tar.gz: 0def7843e02bfa558090f72aa9deee01c9383f5dbc2bbdfa7d8864f3b0e41cef
 SHA512:
-  metadata.gz: f68ed0d8be0ead8665425550efbd32d467def35234bff29875d328cabf2ab722da88789ac3a97c60b0cc29a1c299b3c015b9eea0d65ace89677592f12fd2c8d7
-  data.tar.gz: 79d4ead9724546b60ee902815899b79f573cdd6a09a1d51eb93a78dc5062355827b76b2542b1a2150db4461fa8ee459aefdf2f1374816c576fb228dd5ae41b45
+  metadata.gz: e80d762e3fb12eed38918bc931c8b057052800938746ac83d35b86343e129e1aec1ab41a6f85f971ddf7f96fdcba181fd0e9d69971e347cc2b50ee371bb25340
+  data.tar.gz: 882bd1d57135f0e52e55dea6bc6a8660e443c4061e0e629dba35ae0ffff9ea43e0ce61848c2c939d4267452def0be6a546584a79219b1102dedf208f9216843d

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-06-14
+
+### Changed
+- Added package card image to README
+- Added YARD doc comments to Worker public methods
+- Cleaned up CHANGELOG formatting
+
+## [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
@@ -57,7 +69,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fix License section format
 - Sync gemspec summary with README
 
-
 ## [0.2.8] - 2026-03-24
 
 ### Fixed

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-task_queue.svg)](https://rubygems.org/gems/philiprehberger-task_queue)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-task-queue)](https://github.com/philiprehberger/rb-task-queue/commits/main)
 
+![philiprehberger-task_queue](https://raw.githubusercontent.com/philiprehberger/rb-task-queue/main/package-card.webp)
+
 In-process async job queue with concurrency control
 
 ## Requirements
@@ -205,6 +207,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 |

data/lib/philiprehberger/task_queue/queue.rb

@@ -173,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.6.0'
+    VERSION = '0.7.1'
   end
 end

data/lib/philiprehberger/task_queue/worker.rb

@@ -20,10 +20,17 @@ module Philiprehberger
         @thread = Thread.new { run }
       end
 
+      # Signal the worker to stop after its current task completes.
+      #
+      # @return [void]
       def stop
         @running = false
+        nil
       end
 
+      # Whether the underlying worker thread is still alive.
+      #
+      # @return [Boolean]
       def alive?
         @thread&.alive? || false
       end

metadata

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