shoryuken 7.0.3 → 7.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 988d29701fd4b73dea7d965b283ae8d3fccf5b9737a7e3acdfe5cc760ca82cc5
-  data.tar.gz: b91a7b40cab94ca17fb432433a81323deba9675a3398678c80db1b3a7aa454fb
+  metadata.gz: b332f880ab52b8380e13758f98bbca5d35a5a21f693753d536564c2dc760eadb
+  data.tar.gz: 9660f222a93c1fc517cc7f65bf029ee6c31e9a6b5526d67af917a91e64768ca4
 SHA512:
-  metadata.gz: e6bc156e3e5387ad74c4a740cae775f6f633b67c26395a3aac11e51b7cc47771785918e5ec457d3f2317148846ef3ad0b137b5f6e012f3f75aec6536a2eb2deb
-  data.tar.gz: 87f0feeae55309458dbd5eab9fea4fbdb83a5689bd526b0e22857cb89f0af7027346f2e1487614965b3208aafaf6167dc7bb2573e160d45cfb54e8133baa09c0
+  metadata.gz: ce8200034dfe12e010bbb928f73d7ae35f2abfda4d85235cc7af189d26306d254bfd84e6956dace838ba0a222768628cf2c4785f657f8c23cd07ddc47219064a
+  data.tar.gz: c7a947da8aa8dadd9f79bedd89d02a67cfd715e715294d5e38a396cbb7070e5a06b4aa4055e347493eaa9373242593a5eacaed27ebb7528f16b21d8007a44825

data/.github/workflows/push.yml

@@ -19,12 +19,12 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
           fetch-depth: 0
 
       - name: Set up Ruby
-        uses: ruby/setup-ruby@d45b1a4e94b71acab930e56e79c6aa188764e7f9 # v1.316.0
+        uses: ruby/setup-ruby@a0102e0972be65f351c307e2d64b9314a57c8073 # v1.324.0
         with:
           bundler-cache: false
 
@@ -33,4 +33,4 @@ jobs:
           bundle install --jobs 4 --retry 3
 
       # Release
-      - uses: rubygems/release-gem@052cc82692552de3ef2b81fd670e41d13cba8092 # v1.4.0
+      - uses: rubygems/release-gem@7f9650160c1a4e7989fdc9855807bdbd421d8b6b # v1.4.1

data/.github/workflows/specs.yml

@@ -16,9 +16,9 @@ jobs:
     timeout-minutes: 10
     steps:
       - name: Checkout code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
 
-      - uses: ruby/setup-ruby@d45b1a4e94b71acab930e56e79c6aa188764e7f9 # v1.316.0
+      - uses: ruby/setup-ruby@a0102e0972be65f351c307e2d64b9314a57c8073 # v1.324.0
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
@@ -57,7 +57,7 @@ jobs:
     timeout-minutes: 15
     steps:
       - name: Checkout code
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
 
       - name: Start ElasticMQ
         run: docker compose up -d
@@ -71,7 +71,7 @@ jobs:
           done
           '
 
-      - uses: ruby/setup-ruby@d45b1a4e94b71acab930e56e79c6aa188764e7f9 # v1.316.0
+      - uses: ruby/setup-ruby@a0102e0972be65f351c307e2d64b9314a57c8073 # v1.324.0
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true

data/.github/workflows/verify-action-pins.yml

@@ -7,7 +7,7 @@ jobs:
   verify:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - name: Check SHA pins
         run: |
           if grep -E -r "uses: .*/.*@(v[0-9]+|main|master)($|[[:space:]]|$)" --include="*.yml" --include="*.yaml" .github/workflows/ | grep -v "#"; then

data/.ruby-version

@@ -1 +1 @@
-4.0.5
+4.0.7

data/.yard-lint.yml

@@ -66,6 +66,34 @@ Documentation/BlankLineBeforeDefinition:
     SingleBlankLine: true
     OrphanedDocs: true
 
+Documentation/DuplicateNamespaceComment:
+  Description: Detects namespaces documented with a YARD comment in more than one file.
+  Enabled: true
+  Severity: error
+
+Documentation/UnderfilledLines:
+  Description: Detects documentation prose that wraps too early and wastes horizontal space.
+  Enabled: true
+  Severity: error
+  # Aligned with RuboCop's Layout/LineLength so documentation prose wraps to the same
+  # width as code.
+  MaxLength: 125
+
+Documentation/LineLength:
+  Description: Detects documentation lines that exceed the maximum length.
+  Enabled: true
+  Severity: error
+  # Aligned with RuboCop's Layout/LineLength.
+  MaxLength: 125
+
+Documentation/TextSubstitution:
+  Description: Detects em/en-dashes in documentation and replaces them with hyphens.
+  Enabled: true
+  Severity: error
+  Substitutions:
+    "—": "-"    # em-dash (U+2014)
+    "–": "-"    # en-dash (U+2013)
+
 # Tags validators
 Tags/Order:
   Description: Enforces consistent ordering of YARD tags.
@@ -146,7 +174,7 @@ Tags/OptionTags:
 Tags/ExampleSyntax:
   Description: Validates Ruby syntax in @example tags.
   Enabled: true
-  Severity: warning
+  Severity: error
 
 Tags/RedundantParamDescription:
   Description: Detects meaningless parameter descriptions that add no value.

data/CHANGELOG.md

@@ -1,4 +1,68 @@
-## [Unreleased]
+## [7.0.4] - 2026-09-23
+
+- Fix: `shoryuken sqs dump`/`mv` no longer stop early on real SQS (mensfeld)
+  - `find_all` used short polling and broke on the first empty `receive_message` response. Real
+    (distributed) SQS routinely returns an empty batch while the queue still has messages, so dump/mv
+    quietly processed only a fraction of the queue (invisible on single-node ElasticMQ/LocalStack)
+  - It now long-polls and only stops after several consecutive empty batches, so the queue is actually drained
+  - Because a longer drain can outlast the queue's visibility timeout (dump/mv delete only after `find_all`
+    returns), re-read messages are now deduplicated by message id, so they are not dumped/moved or counted
+    twice, and the newest receipt handle is kept so the deferred delete still succeeds
+  - Deletion stays deferred (a failed dump/mv deletes nothing), so a queue larger than SQS's in-flight limit
+    (~120k standard / ~20k FIFO) drains over multiple runs rather than one - no message is lost
+
+- Fix: Graceful stop no longer deadlocks when a manager's dispatch loop never started (mensfeld)
+  - `await_dispatching_in_progress` blocks on a `Queue` that is only closed from inside `dispatch_loop` when it
+    observes the stop flag. If the loop never runs - a graceful stop arriving before the start `Future` is
+    scheduled, or an embedded host whose executor pool is saturated so `manager.start` never runs - the signal
+    was never closed and `Launcher#stop` deadlocked
+  - `stop_new_dispatching` now closes the release signal itself when the loop hasn't started (tracked via a new
+    flag); `Queue#close` is idempotent, so a loop that does start later and closes it again is harmless
+
+- Feature: `Shoryuken.fifo_message_deduplication` to opt out of content-based dedup id generation for raw sends (mensfeld)
+  - `Queue#add_fifo_attributes!` always set `message_deduplication_id` to a SHA256 of the body when none was
+    given, so two raw sends of an identical body within SQS's 5-minute window (`Worker.perform_async`,
+    `Queue#send_message`/`#send_messages`) were silently deduplicated - the second dropped. ActiveJob got an
+    opt-out in #1017 but the raw path had none
+  - Set `Shoryuken.fifo_message_deduplication = false` to stop auto-generating that id, so identical bodies are
+    no longer silently dropped (provide a `message_deduplication_id` yourself or enable
+    `ContentBasedDeduplication` on the queue)
+  - Defaults to `true`, preserving the existing behavior; an explicit `message_deduplication_id` is still honored
+
+- Fix: Harden `ExponentialBackoffRetry` visibility handling (mensfeld)
+  - `next_visibility_timeout` could return a negative value when a job ran past the 12h SQS ceiling (its
+    `max_timeout` goes below zero), and `change_message_visibility` rejects a negative timeout; it now clamps
+    to 0 so the message is retried as soon as possible
+  - `handle_failure` called `change_visibility` unguarded, so a failure there (e.g. an expired receipt handle)
+    escaped the `rescue` in `#call` and masked the original worker error from exception handlers/notifiers; it
+    now rescues, logs, and reports "not retried" so the original error is re-raised and the message falls back
+    to the queue's default visibility timeout
+  - The failure `rescue` in `#call` is now scoped to the single-message `yield` only, so a batch worker's error
+    no longer routes the message Array into `handle_failure` (raising a `NoMethodError` that masked the original)
+
+- Fix: `perform_async` no longer mutates the caller-supplied options hash (mensfeld)
+  - `DefaultExecutor#perform_async` and `InlineExecutor#perform_async` deleted `:queue`, injected
+    `:message_body`, and wrote `shoryuken_class` into the nested `:message_attributes` in place, so a caller
+    reusing one options hash across enqueues had `:queue` stripped after the first call - silently routing later
+    jobs to the worker's default queue
+  - Both now operate on a `dup` and rebuild `:message_attributes` with `merge`, leaving the caller's hash untouched
+
+- Fix: `Shoryuken::Client.queues` no longer builds the same queue more than once under concurrency (mensfeld)
+  - The cache used an unsynchronized `@@queues[name] ||= Shoryuken::Queue.new(...)`. Building a queue makes
+    SQS API calls, and that I/O releases the GVL, so concurrent first-access (dispatch, processor-completion
+    and worker threads all call it) built the queue multiple times - redundant API calls, and a corrupt cache
+    on JRuby/TruffleRuby
+  - Access to the cache is now guarded by a mutex
+
+- Fix: Busy-processor counter no longer leaks when the executor rejects a worker post (mensfeld)
+  - `Manager#assign` increments `@busy_processors` before posting the worker `Concurrent::Promise`, but the
+    matching decrement (`processor_done`) runs inside the promise body. When the post is rejected with
+    `Concurrent::RejectedExecutionError` - a hard stop racing the `running?` check, or a saturated bounded custom
+    `launcher_executor` - the body never runs and the counter leaks
+  - With a bounded executor the leak is permanent: `ready` (`@max_processors - busy`) keeps shrinking until
+    dispatch stalls and the group silently stops processing
+  - The increment is now rolled back on `RejectedExecutionError` by decrementing directly (the message was never
+    processed, so the FIFO `message_processed` callback must not run) (#1029)
 
 ## [7.0.3] - 2026-07-10
 

data/Gemfile.lint.lock

@@ -31,11 +31,11 @@ GEM
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
-    yard (0.9.38)
-    yard-lint (1.4.0)
+    yard (0.9.45)
+    yard-lint (1.10.2)
       yard (~> 0.9)
       zeitwerk (~> 2.6)
-    zeitwerk (2.7.4)
+    zeitwerk (2.8.2)
 
 PLATFORMS
   ruby
@@ -47,6 +47,7 @@ DEPENDENCIES
 
 CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  bundler (4.0.17) sha256=214e21431b5665dd2f99df8a5511c6b151d7a72e8015c8b38f8b775b61cbb6c1
   json (2.18.0) sha256=b10506aee4183f5cf49e0efc48073d7b75843ce3782c68dbeb763351c08fd505
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
@@ -61,9 +62,9 @@ CHECKSUMS
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
   unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
-  yard (0.9.38) sha256=721fb82afb10532aa49860655f6cc2eaa7130889df291b052e1e6b268283010f
-  yard-lint (1.4.0) sha256=7dd88fbb08fd77cb840bea899d58812817b36d92291b5693dd0eeb3af9f91f0f
-  zeitwerk (2.7.4) sha256=2bef90f356bdafe9a6c2bd32bcd804f83a4f9b8bc27f3600fff051eb3edcec8b
+  yard (0.9.45) sha256=52e211493f7cb8a3ebf7e104a25a1e73937a3103092545d34cb88fafebb3dc51
+  yard-lint (1.10.2) sha256=3e595709d088a8cc827e706a4146b447eb6a907ee375d06c11077369d00717f6
+  zeitwerk (2.8.2) sha256=7212a61311083c604184b1ea2574b9aa05cd14f855a0841c06985cabe9181d12
 
 BUNDLED WITH
-  4.0.3
+  4.0.17

data/bin/cli/sqs.rb

@@ -12,6 +12,14 @@ module Shoryuken
       # @see https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
       MAX_BATCH_SIZE = 1024 * 1024
 
+      # Long-poll wait (seconds) used when draining a queue in find_all, so a
+      # short-poll empty batch doesn't end dump/mv prematurely.
+      FIND_ALL_WAIT_SECONDS = 1
+
+      # Number of consecutive empty long-poll batches before find_all concludes
+      # the queue is drained.
+      FIND_ALL_MAX_EMPTY_BATCHES = 3
+
       namespace :sqs
       class_option :endpoint, aliases: '-e', type: :string, default: ENV['SHORYUKEN_SQS_ENDPOINT'], desc: 'Endpoint URL'
 
@@ -170,6 +178,25 @@ module Shoryuken
         # @return [Integer] the number of messages received
         def find_all(url, limit, &block)
           count = 0
+          empty_batches = 0
+          # Callers (dump/mv) collect messages and only delete them after this
+          # method returns (so a failed dump/mv deletes nothing), which means
+          # nothing is removed from the queue during the drain. Two consequences:
+          #
+          #   1. A large drain can outlast the queue's visibility timeout, at
+          #      which point already-received messages become visible again and
+          #      are handed back on a later receive. `seen` maps message id to
+          #      the first yielded message so those re-reads are not yielded,
+          #      counted, or dumped/moved twice - but the newest receipt handle
+          #      is copied onto that message, because SQS only honors the most
+          #      recently received handle for deletion (an older one can report
+          #      success yet leave the message in the queue).
+          #   2. Because messages stay in flight until the caller deletes them,
+          #      a queue larger than SQS's in-flight limit (~120k standard /
+          #      ~20k FIFO) cannot be drained in a single pass: once the limit
+          #      is reached receive returns empty and find_all stops. No message
+          #      is lost - re-run dump/mv to drain the remainder.
+          seen = {}
           batch_size = limit > 10 ? 10 : limit
 
           loop do
@@ -179,16 +206,46 @@ module Shoryuken
             messages = sqs.receive_message(
               queue_url: url,
               max_number_of_messages: batch_size,
+              # Long poll: short polling (the default wait_time_seconds: 0)
+              # samples only a subset of SQS hosts and routinely returns an empty
+              # batch even when the queue still has messages, which made dump/mv
+              # stop early and miss messages on real (distributed) SQS.
+              wait_time_seconds: FIND_ALL_WAIT_SECONDS,
               attribute_names: ['All'],
               message_attribute_names: ['All']
             ).messages || []
 
-            messages.each(&block)
+            # Split first-time messages from re-reads (same id handed back after
+            # the visibility timeout lapsed). A batch of only re-reads counts as
+            # empty so the drain still terminates.
+            fresh = []
+            messages.each do |message|
+              if (previous = seen[message.message_id])
+                # Keep the newest receipt handle on the already-yielded message
+                # so the caller's deferred batch_delete targets a handle SQS
+                # still accepts.
+                previous.receipt_handle = message.receipt_handle
+              else
+                seen[message.message_id] = message
+                fresh << message
+              end
+            end
 
-            count += messages.size
+            fresh.each(&block)
+
+            count += fresh.size
 
             break if count >= limit
-            break if messages.empty?
+
+            # Even with long polling an occasional empty batch is possible while
+            # messages remain, so only give up after several consecutive batches
+            # that yielded no new messages.
+            if fresh.empty?
+              empty_batches += 1
+              break if empty_batches >= FIND_ALL_MAX_EMPTY_BATCHES
+            else
+              empty_batches = 0
+            end
           end
 
           count

data/lib/active_job/extensions.rb

@@ -2,9 +2,8 @@
 
 module Shoryuken
   module ActiveJob
-    # Adds an accessor for SQS SendMessage parameters on ActiveJob jobs
-    # (instances of ActiveJob::Base). Shoryuken ActiveJob queue adapters use
-    # these parameters when enqueueing jobs; other adapters can ignore them.
+    # Adds an accessor for SQS SendMessage parameters on ActiveJob jobs (instances of ActiveJob::Base). Shoryuken ActiveJob
+    # queue adapters use these parameters when enqueueing jobs; other adapters can ignore them.
     module SQSSendMessageParametersAccessor
       extend ActiveSupport::Concern
 
@@ -14,14 +13,12 @@ module Shoryuken
       end
     end
 
-    # Initializes SQS SendMessage parameters on instances of ActiveJob::Base
-    # to the empty hash, and populates it whenever `#enqueue` is called, such
-    # as when using ActiveJob::Base.set.
+    # Initializes SQS SendMessage parameters on instances of ActiveJob::Base to the empty hash, and populates it whenever
+    # `#enqueue` is called, such as when using ActiveJob::Base.set.
     module SQSSendMessageParametersSupport
       # Initializes a new ActiveJob instance with empty SQS parameters
       #
-      # Uses argument forwarding (...) to properly pass all arguments including
-      # keyword arguments to the base class.
+      # Uses argument forwarding (...) to properly pass all arguments including keyword arguments to the base class.
       def initialize(...)
         super(...)
         self.sqs_send_message_parameters = {}

data/lib/active_job/queue_adapters/shoryuken_adapter.rb

@@ -13,7 +13,7 @@ module ActiveJob
     # Shoryuken adapter for Active Job.
     # To use Shoryuken set the queue_adapter config to +:shoryuken+.
     #
-    # @example Rails configuration
+    # Example Rails configuration:
     #   Rails.application.config.active_job.queue_adapter = :shoryuken
 
     # Determine the appropriate base class based on Rails version
@@ -63,9 +63,8 @@ module ActiveJob
 
       # Indicates whether Shoryuken is in the process of shutting down.
       #
-      # This method is required for ActiveJob Continuations support (Rails 8.1+).
-      # When true, it signals to jobs that they should checkpoint their progress
-      # and gracefully interrupt execution to allow for resumption after restart.
+      # This method is required for ActiveJob Continuations support (Rails 8.1+). When true, it signals to jobs that they
+      # should checkpoint their progress and gracefully interrupt execution to allow for resumption after restart.
       #
       # @return [Boolean] true if Shoryuken is shutting down, false otherwise
       # @see https://github.com/rails/rails/pull/55127 Rails ActiveJob Continuations

data/lib/shoryuken/active_job/current_attributes.rb

@@ -11,12 +11,10 @@ module Shoryuken
     # This ensures that request-scoped context (like current user, tenant, locale)
     # automatically flows from the code that enqueues a job to the job's execution.
     #
-    # Based on Sidekiq's approach to persisting current attributes, with one
-    # deliberate difference in cleanup: Sidekiq only touches the classes carried
-    # by a job and leaves the general reset to the Rails executor it runs jobs
-    # inside. Shoryuken does not run jobs inside that executor by default, so the
-    # loader resets every registered class after each job itself - see the note
-    # on {Loading#perform}.
+    # Based on Sidekiq's approach to persisting current attributes, with one deliberate difference in cleanup: Sidekiq only
+    # touches the classes carried by a job and leaves the general reset to the Rails executor it runs jobs inside. Shoryuken
+    # does not run jobs inside that executor by default, so the loader resets every registered class after each job itself -
+    # see the note on {Loading#perform}.
     #
     # @example Setup in initializer
     #   require 'shoryuken/active_job/current_attributes'

data/lib/shoryuken/body_parser.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module Shoryuken
-  # Parses SQS message bodies according to worker configuration.
-  # Supports JSON parsing, text extraction, custom Procs, and
+  # Parses SQS message bodies according to worker configuration. Supports JSON parsing, text extraction, custom Procs, and
   # any object that responds to parse or load methods.
   class BodyParser
     class << self

data/lib/shoryuken/client.rb

@@ -4,16 +4,22 @@ module Shoryuken
   # Client class for interacting with SQS queues.
   # Provides a simple interface for accessing and managing queue instances.
   class Client
-    # @return [Hash{String => Shoryuken::Queue}] cached queue instances by name
+    # Cached queue instances by name (Hash{String => Shoryuken::Queue}).
     @@queues = {}
 
+    # Guards the queue cache. queues is called concurrently from the dispatch
+    # thread, processor-completion threads and worker threads, and building a
+    # Shoryuken::Queue makes SQS API calls, so an unsynchronized `||=` would let
+    # several callers build the same queue (and corrupt the hash on JRuby).
+    @@queues_mutex = Mutex.new
+
     class << self
       # Returns a Queue instance for the given queue name
       #
       # @param name [String, Symbol] the name of the queue
       # @return [Shoryuken::Queue] the queue instance
       def queues(name)
-        @@queues[name.to_s] ||= Shoryuken::Queue.new(sqs, name)
+        @@queues_mutex.synchronize { @@queues[name.to_s] ||= Shoryuken::Queue.new(sqs, name) }
       end
 
       # Returns the current SQS client
@@ -29,10 +35,13 @@ module Shoryuken
       # @return [Aws::SQS::Client] the SQS client
       def sqs=(sqs)
         # Since the @@queues values (Shoryuken::Queue objects) are built referencing @@sqs, if it changes, we need to
-        #   re-build them on subsequent calls to `.queues(name)`.
-        @@queues = {}
-
-        Shoryuken.sqs_client = sqs
+        #   re-build them on subsequent calls to `.queues(name)`. Swap the client and reset the cache inside the same
+        #   critical section: otherwise a concurrent `queues` call could slip between the reset and the assignment,
+        #   read the old client, and cache a queue built with it that survives the replacement.
+        @@queues_mutex.synchronize do
+          Shoryuken.sqs_client = sqs
+          @@queues = {}
+        end
       end
     end
   end

data/lib/shoryuken/default_exception_handler.rb

@@ -1,9 +1,8 @@
 # frozen_string_literal: true
 
 module Shoryuken
-  # Default exception handler that logs errors during message processing.
-  # Implements a simple error logging strategy that outputs the exception
-  # message and backtrace to the configured logger.
+  # Default exception handler that logs errors during message processing. Implements a simple error logging strategy that
+  # outputs the exception message and backtrace to the configured logger.
   class DefaultExceptionHandler
     extend Util
 

data/lib/shoryuken/errors.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module Shoryuken
-  # Namespace for all Shoryuken-specific errors.
-  # These provide more meaningful error types than generic Ruby exceptions,
+  # Namespace for all Shoryuken-specific errors. These provide more meaningful error types than generic Ruby exceptions,
   # making it easier to rescue and handle specific failure cases.
   module Errors
     # Base class for all Shoryuken errors
@@ -14,8 +13,7 @@ module Shoryuken
     # Raised when a specified SQS queue does not exist or cannot be accessed
     QueueNotFoundError = Class.new(BaseError)
 
-    # Raised when worker registration fails due to conflicts
-    # (e.g., registering multiple workers for a batch queue)
+    # Raised when worker registration fails due to conflicts (e.g., registering multiple workers for a batch queue)
     InvalidWorkerRegistrationError = Class.new(BaseError)
 
     # Raised when an invalid polling strategy is specified

data/lib/shoryuken/helpers/atomic_counter.rb

@@ -4,13 +4,11 @@ module Shoryuken
   module Helpers
     # A thread-safe counter implementation using Ruby's Mutex.
     #
-    # This class provides atomic operations for incrementing, decrementing, and reading
-    # integer values in a thread-safe manner. It serves as a drop-in replacement for
-    # Concurrent::AtomicFixnum without requiring external dependencies.
+    # This class provides atomic operations for incrementing, decrementing, and reading integer values in a thread-safe
+    # manner. It serves as a drop-in replacement for Concurrent::AtomicFixnum without requiring external dependencies.
     #
-    # The implementation uses a Mutex to ensure thread safety across all Ruby
-    # implementations including JRuby, where true parallelism makes atomic operations
-    # critical for data integrity.
+    # The implementation uses a Mutex to ensure thread safety across all Ruby implementations including JRuby, where true
+    # parallelism makes atomic operations critical for data integrity.
     #
     # @note This class is optimized for scenarios with frequent atomic updates
     #   and occasional reads, such as tracking active worker counts.
@@ -82,9 +80,8 @@ module Shoryuken
 
       # Atomically decrements the counter by 1 and returns the new value.
       #
-      # This operation is thread-safe and can be called concurrently from
-      # multiple threads without risk of data corruption or lost updates.
-      # The counter can go negative if decremented below zero.
+      # This operation is thread-safe and can be called concurrently from multiple threads without risk of data corruption or
+      # lost updates. The counter can go negative if decremented below zero.
       #
       # @return [Integer] The new counter value after decrementing
       #

data/lib/shoryuken/helpers/atomic_hash.rb

@@ -4,14 +4,12 @@ module Shoryuken
   module Helpers
     # A thread-safe hash implementation using Ruby's Mutex for all operations.
     #
-    # This class provides a hash-like interface with thread-safe operations, serving as a
-    # drop-in replacement for Concurrent::Hash without requiring external dependencies.
-    # The implementation uses a single mutex to protect both read and write operations,
-    # ensuring complete thread safety across all Ruby implementations including JRuby.
+    # This class provides a hash-like interface with thread-safe operations, serving as a drop-in replacement for
+    # Concurrent::Hash without requiring external dependencies. The implementation uses a single mutex to protect both read
+    # and write operations, ensuring complete thread safety across all Ruby implementations including JRuby.
     #
-    # Since hash operations (lookup, assignment) are very fast, the mutex overhead is
-    # minimal while providing guaranteed safety and simplicity. This approach avoids
-    # the complexity of copy-on-write while maintaining excellent performance for
+    # Since hash operations (lookup, assignment) are very fast, the mutex overhead is minimal while providing guaranteed
+    # safety and simplicity. This approach avoids the complexity of copy-on-write while maintaining excellent performance for
     # typical usage patterns.
     #
     # @note This implementation uses mutex synchronization for all operations,
@@ -52,8 +50,7 @@ module Shoryuken
     class AtomicHash
       # Creates a new empty atomic hash.
       #
-      # The hash starts empty and ready to accept key-value pairs through
-      # thread-safe operations.
+      # The hash starts empty and ready to accept key-value pairs through thread-safe operations.
       #
       # @return [AtomicHash] A new empty atomic hash instance
       #
@@ -67,8 +64,7 @@ module Shoryuken
 
       # Returns the value associated with the given key.
       #
-      # This operation is thread-safe and will return a consistent value
-      # even when called concurrently with write operations.
+      # This operation is thread-safe and will return a consistent value even when called concurrently with write operations.
       #
       # @param key [Object] The key to look up
       # @return [Object, nil] The value associated with the key, or nil if not found
@@ -115,8 +111,7 @@ module Shoryuken
 
       # Removes all key-value pairs from the hash.
       #
-      # This is a thread-safe write operation that ensures atomicity
-      # when called concurrently with other operations.
+      # This is a thread-safe write operation that ensures atomicity when called concurrently with other operations.
       #
       # @return [Hash] An empty hash (for compatibility with standard Hash#clear)
       #
@@ -154,8 +149,7 @@ module Shoryuken
 
       # Returns the value for the given key, or a default value if the key is not found.
       #
-      # This operation is thread-safe and will return a consistent value
-      # even when called concurrently with write operations.
+      # This operation is thread-safe and will return a consistent value even when called concurrently with write operations.
       #
       # @param key [Object] The key to look up
       # @param default [Object] The value to return if the key is not found

data/lib/shoryuken/helpers/hash_utils.rb

@@ -4,10 +4,9 @@ module Shoryuken
   module Helpers
     # Utility methods for hash manipulation.
     #
-    # This module provides helper methods for common hash operations that were
-    # previously implemented as core class extensions. By using a dedicated
-    # helper module, we avoid polluting the global namespace while maintaining
-    # the same functionality.
+    # This module provides helper methods for common hash operations that were previously implemented as core class
+    # extensions. By using a dedicated helper module, we avoid polluting the global namespace while maintaining the same
+    # functionality.
     #
     # @example Basic usage
     #   hash = { 'key1' => 'value1', 'key2' => { 'nested' => 'value2' } }
@@ -17,9 +16,8 @@ module Shoryuken
       class << self
         # Recursively converts hash keys to symbols.
         #
-        # This method traverses a hash structure and converts all string keys
-        # to symbols, including nested hashes. Non-hash values are left unchanged.
-        # This is useful for normalizing configuration data loaded from YAML files.
+        # This method traverses a hash structure and converts all string keys to symbols, including nested hashes. Non-hash
+        # values are left unchanged. This is useful for normalizing configuration data loaded from YAML files.
         #
         # @param hash [Hash, Object] The hash to convert, or any other object
         # @return [Hash, Object] Hash with symbolized keys, or the original object if not a hash

data/lib/shoryuken/helpers/string_utils.rb

@@ -4,10 +4,9 @@ module Shoryuken
   module Helpers
     # Utility methods for string manipulation.
     #
-    # This module provides helper methods for common string operations that were
-    # previously implemented as core class extensions. By using a dedicated
-    # helper module, we avoid polluting the global namespace while maintaining
-    # the same functionality.
+    # This module provides helper methods for common string operations that were previously implemented as core class
+    # extensions. By using a dedicated helper module, we avoid polluting the global namespace while maintaining the same
+    # functionality.
     #
     # @example Basic usage
     #   klass = Shoryuken::Helpers::StringUtils.constantize('MyWorker')
@@ -16,10 +15,9 @@ module Shoryuken
       class << self
         # Converts a string to a constant.
         #
-        # This method takes a string representation of a constant name and returns
-        # the actual constant. It handles nested constants (e.g., 'Foo::Bar') and
-        # leading double colons (e.g., '::Object'). This is commonly used for
-        # dynamically loading worker classes from configuration.
+        # This method takes a string representation of a constant name and returns the actual constant. It handles nested
+        # constants (e.g., 'Foo::Bar') and leading double colons (e.g., '::Object'). This is commonly used for dynamically
+        # loading worker classes from configuration.
         #
         # @param string [String] The string to convert to a constant
         # @return [Class, Module] The constant represented by the string

data/lib/shoryuken/inline_message.rb

@@ -3,10 +3,9 @@
 module Shoryuken
   # A high-performance alternative to OpenStruct for representing SQS messages.
   #
-  # InlineMessage is a Struct-based implementation that provides the same interface
-  # as the previous OpenStruct-based message representation but with significantly
-  # better performance characteristics. It contains all the essential attributes
-  # needed to represent an Amazon SQS message within the Shoryuken framework.
+  # InlineMessage is a Struct-based implementation that provides the same interface as the previous OpenStruct-based message
+  # representation but with significantly better performance characteristics. It contains all the essential attributes needed
+  # to represent an Amazon SQS message within the Shoryuken framework.
   InlineMessage = Struct.new(
     :body,
     :attributes,