resque-scheduler 5.0.0 → 5.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e23e91d3c9920396d8feaad257fe4a27f4ff269f6cd0d6f9756016599d7cdf27
-  data.tar.gz: 7c1c242fd5c2ed74f8c15924d476775f76ed4929fb65d31b965e708c5949a601
+  metadata.gz: 6aa6e1f1a8fe48f091032409157797e48011e473fca30c8fd12d18d05517de49
+  data.tar.gz: cbcc8d19930096797a1d028a9765b9c7c0b65ae023011ccec64cf8005420f183
 SHA512:
-  metadata.gz: c90721652b59bdc1f2572975d3ef93ed9aa420f36a6a8f3a0c5a35f17a3e5145ebdd30bfacf7d62e4903f9477319282c8a33d55080f5c870c84161f4933e79d4
-  data.tar.gz: 061fc1d3dfea48a20db7e8c11b31fe0b2e6594d9be0ed5c202c38f304941bceb8c1f15497d0c0ec886c0ddd37fc867b6dd1b5e143e9bb5961cd01b41f73d2e5e
+  metadata.gz: a3842dbcedbb2768e715aef2355f11333cadfa101ccb5a1475dbda155005d494408e0554c027ba5cf72afcabc7dcd3778125b9f512680850c875efbccb94f64f
+  data.tar.gz: 9623d1a81de5c0e1179e7be932ad6a19641dbcbc57c7b9034fc531160ae6e896374611d5d0f1dc64a710c27293cbc0e1db0eda9f6e5ad4c5ed8208398e20cdae

data/.github/workflows/ruby.yml

@@ -6,9 +6,11 @@ on:
   pull_request:
     branches: [master]
 
+permissions:
+  contents: read
+
 jobs:
   test:
-    continue-on-error: true
     runs-on: ubuntu-latest
     services:
       redis:
@@ -19,20 +21,16 @@ jobs:
       fail-fast: false
       matrix:
         ruby-version:
-          - "3.0"
-          - 3.1
           - 3.2
           - 3.3
           - 3.4
+          - "4.0"
           - head
         resque-version:
           - "master"
-        rufus-scheduler:
-          - "3.4"
-          - "3.5"
-          - "3.6"
         redis-version:
           - "4.8"
+          - "5.4"
           - "latest"
         rack-version:
           - 2
@@ -40,15 +38,24 @@ jobs:
     env:
       REDIS_VERSION: "${{ matrix.redis-version }}"
       RESQUE: "${{ matrix.resque-version }}"
-      RUFUS_SCHEDULER: "${{ matrix.rufus-scheduler }}"
       RACK_VERSION: "${{ matrix.rack-version }}"
       COVERAGE: 1
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: "${{ matrix.ruby-version }}"
           bundler-cache: true
       - run: bundle exec rake
       - run: bin/bundle_console_test.sh
+
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.4
+          bundler-cache: true
+      - run: bundle exec rubocop

data/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 **ATTN**: This project uses [semantic versioning](http://semver.org/).
 
+## [5.1.0] - 2026-10-28
+### Breaking Changes
+* Ruby requirement: `>= 3.0.0` → `>= 3.2.0` by @neuromanskie in #837
+* rufus-scheduler dependency: `~> 3.2, != 3.3` → `~> 3.9` by @neuromanskie in #837
+* Schedule entries (`cron`/`every`) no longer run `before_schedule`, `after_schedule` or `before_delayed_enqueue`. Move that code to `before_recurring`/`after_recurring` by @top-sigrid in #844
+
+### Added
+* `before_recurring` and `after_recurring` hooks for jobs enqueued from the schedule by @top-sigrid in #844
+* `DISABLE_DELAYED_REQUEUE_BATCHES` to opt out of batched delayed job enqueues by @onyxraven in #796
+* Search delayed jobs by args in the web UI by @bmo in #839 (originally #714)
+* Allow a number of seconds for `every` by @carsonreinke in #838 (originally #607)
+* Railtie to load resque-scheduler automatically in Rails apps by @josh-m-sharpe in #694
+* Add Ruby 4.0 and redis-rb 5.4 to the CI matrix by @neuromanskie in #837
+
+### Changed
+* Upgrade RuboCop to 1.91 and run it as a CI job by @neuromanskie in #837
+
+### Fixed
+* Delayed jobs no longer run `before_schedule`/`after_schedule` a second time when they become due by @top-sigrid in #844
+* Skip schedule hooks when `enqueue_at` is given a timestamp that is not in the future by @top-sigrid in #817
+* Schedule Active Job classes through `perform_later` by @neuromanskie and @josh-m-sharpe in #842 (originally #696)
+* Schedule delayed test jobs far enough out to not race the clock by @neuromanskie in #843
+* Fail CI when tests fail by @neuromanskie in #837
+
+## [5.0.1] - 2026-10-11
+### Changed
+* Pipeline `count_all_scheduled_jobs` for significantly faster execution by @top-sigrid in #822
+* Avoid unnecessary reloads in static mode by @ekmartin in #823
+
+### Fixed
+* Skip invalid schedules without interrupting scheduler loading by @taf2 in #543
+* Encode a delayed job once so its timestamps key can be cleaned up by @kamaljoshi in #827 (originally #599)
+* Log to the logfile when backgrounded by @meatballhat in #828 (originally #568)
+* Require redis before using its error classes by @neuromanskie in #829
+* Fix flaky test by using strings instead of symbols for JSON-serialized args by @top-sigrid in #813
+
+### Security
+* Escape job class and queue names in the scheduler web UI by @PatrickTulskie in #830
+* Escape schedule names and parameters on the requeue params page by @PatrickTulskie in #831
+* Escape the scheduler environment and master lock holder on the schedule page by @PatrickTulskie in #832
+
 ## [5.0.0] - 2026-01-15
 ### Breaking Changes
 * Ruby requirement: `>= 2.3.0` → `>= 3.0.0`
@@ -32,7 +73,7 @@
 * Fixed test compatibility with Rack 3 by @PatrickTulskie in #809
 * Fixed race condition in scheduler task tests by @PatrickTulskie in #809
 
-## [4.10.3] - 2024-12-30
+## [4.11.0] - 2024-12-30
 ### Added
 * Expose timeout for lock via environment variable configuration by @pmm4654 in #786
 * Add Ruby 3.3 to the CI matrix by @santiagorodriguez96 in #797

data/Gemfile

@@ -8,13 +8,6 @@ else
   gem 'resque', resque_version
 end
 
-case rufus_scheduler_version = ENV.fetch('RUFUS_SCHEDULER', '3.6')
-when 'master'
-  gem 'rufus-scheduler', git: 'https://github.com/jmettraux/rufus-scheduler'
-else
-  gem 'rufus-scheduler', rufus_scheduler_version
-end
-
 case redis_version = ENV.fetch('REDIS_VERSION', 'latest')
 when 'master'
   gem 'redis', git: 'https://github.com/redis/redis-rb'

data/README.md

@@ -48,6 +48,9 @@ Adding the resque:scheduler rake task:
 require 'resque/scheduler/tasks'
 ```
 
+In a Rails app, you can skip this step. A Railtie loads the
+`resque:scheduler` rake task and the Resque web UI tabs automatically.
+
 ### Rake integration
 
 By default, `resque-scheduler` depends on the "resque:setup" rake task.
@@ -131,6 +134,8 @@ environment variables:
 * `APP_NAME` - Application name used in procline (`$0`) (default empty)
 * `BACKGROUND` - [Run in the background](#running-in-the-background) if
 non-empty (via `Process.daemon`, if supported) (default `false`)
+* `DELAYED_REQUEUE_BATCH_SIZE` - Set the delayed job batch size if enabled (default `100`). If `<= 1`, this disables batching.
+* `DISABLE_DELAYED_REQUEUE_BATCHES` - Disable batched delayed job queuing (default `false`) - [See section below on consequences](#batched-delayed-job-and-resque-enqueue-hooks)
 * `DYNAMIC_SCHEDULE` - Enables [dynamic scheduling](#dynamic-schedules)
 if non-empty (default `false`)
 * `RAILS_ENV` - Environment to use in procline (`$0`) (default empty)
@@ -199,6 +204,19 @@ Resque.enqueue_at_with_queue(
 )
 ```
 
+#### Active Job
+
+`ActiveJob::Base` subclasses can be passed to `enqueue_at`, `enqueue_in` and
+their `_with_queue` variants, and used as the `class` of a scheduled job. They
+are handed to `perform_later` (with `set(wait_until:)` for delayed jobs), so
+Active Job must be using the `:resque` adapter. The job's `queue_as` applies
+unless a queue is given.
+
+Since the stored class is the adapter's `JobWrapper`, `delayed?`,
+`remove_delayed` and `find_delayed_selection` won't match Active Job classes,
+and [hooks](#hooks) defined on them aren't called. Use Active Job's callbacks
+instead.
+
 The delayed queue is stored in redis and is persisted in the same way the
 standard resque jobs are persisted (redis writing to disk). Delayed jobs differ
 from scheduled jobs in that if your scheduler process is down or workers are
@@ -457,6 +475,8 @@ config[:persist] = true
 Resque.set_schedule(name, config)
 ```
 
+`every` also accepts a number of seconds, so `config[:every] = 1.hour` works too.
+
 Schedules can later be removed by passing their name to the `remove_schedule` method:
 
 ```ruby
@@ -506,13 +526,18 @@ Similar to the `before_enqueue`- and `after_enqueue`-hooks provided in Resque
   the delayed queue. If the hook returns `false`, the job will not be placed on
   the queue.
 * `after_schedule`: Called with the job args after a job is placed on the
-  delayed queue. Any exception raised propagates up to the code with queued the
+  delayed queue. Any exception raised propagates up to the code that queued the
   job.
 * `before_delayed_enqueue`: Called with the job args after the job has been
-  removed from the delayed queue, but not yet put on a normal queue. It is
+  removed from the delayed queue, but not yet put on its work queue. It is
   called before `before_enqueue`-hooks, and on the same job instance as the
   `before_enqueue`-hooks will be invoked on. Return values are ignored.
-* `on_enqueue_failure`: Called with the job args and the exception that was raised
+* `before_recurring`: Called with the job args before a job from the schedule
+  (`cron`, `every` or "Queue now" in resque-web) is put on its work queue. If
+  the hook returns `false`, the job will not be enqueued.
+* `after_recurring`: Called with the job args after a job from the schedule has
+  been put on its work queue, after the `after_enqueue`-hooks.
+* `on_enqueue_failure`: Called with the job config and the exception that was raised
   while enqueueing a job to resque or external application fails.  Return
   values are ignored. For example:
 
@@ -610,6 +635,9 @@ The Delayed tab:
 
 ![The Delayed Tab](http://img.skitch.com/20100111-ne4fcqtc5emkcuwc5qtais2kwx.jpg)
 
+The Delayed tab's search matches job class names, or job arguments when
+"Search Args?" is checked.
+
 #### How do I get the schedule tabs to show up???
 
 To get these to show up you need to pass a file to `resque-web` to tell it to
@@ -752,9 +780,38 @@ This table explains the version requirements for rufus-scheduler
 
 | resque-scheduler | rufus-scheduler |
 |:-----------------|----------------:|
+| `>= 5.1`         | `~> 3.9`        |
 | `~> 4.0`         | `~> 3.0`        |
 | `< 4.0`          | `~> 2.0`        |
 
+##### Batched delayed job and resque enqueue hooks
+
+Batching delayed job queuing can speed up when per-second job counts grows,
+avoiding situations that may cause delayed enqueues to fall behind. This
+batching wraps enqueues in a `multi` pipeline, making far fewer roundtrips to
+the server.
+
+However, in `redis` gem `>= 4.0`, any operations to Redis within the `multi`
+block must use the multi handle so that the actions are captured. Resque's hooks
+do not currently have a way to pass this around, and so compatibility with other
+Resque plugins or hooks which access Redis at enqueue time is impacted with
+batch mode (A main class of plugins this affects are single runner locks which
+use redis for their locking mechanism). In these cases, you should consider
+disabling the batching by setting the `DISABLE_DELAYED_REQUEUE_BATCHES`
+environment variable to `true`.
+
+Detecting when this occurs can be tricky, you must watch for logs
+emitted by your `resque-scheduler` process such as:
+
+```text
+Redis::CommandError: ERR
+MULTI calls can not be nested
+NoMethodError: undefined method nil? for <Redis::Future
+NoMethodError: undefined method `to_i' for <Redis::Future
+```
+
+If you're in this situation, you will also see delayed jobs to not be enqueued
+(they will get dropped). Disabling batching is the workaround.
 
 ### Contributing
 

data/lib/resque/scheduler/cli.rb

@@ -16,7 +16,9 @@ module Resque
       pidfile: 'PIDFILE',
       poll_sleep_amount: 'RESQUE_SCHEDULER_INTERVAL',
       verbose: 'VERBOSE',
-      lock_timeout: 'LOCK_TIMEOUT'
+      lock_timeout: 'LOCK_TIMEOUT',
+      delayed_requeue_batch_size: 'DELAYED_REQUEUE_BATCH_SIZE',
+      disable_delayed_requeue_batches: 'DISABLE_DELAYED_REQUEUE_BATCHES'
     }.freeze
 
     class Cli
@@ -74,6 +76,20 @@ module Resque
         {
           args: ['-v', '--verbose', 'Run with verbose output [VERBOSE]'],
           callback: ->(options) { ->(v) { options[:verbose] = v } }
+        },
+        {
+          args: [
+            '--delayed-requeue-batch-size [DELAYED_REQUEUE_BATCH_SIZE]',
+            'Delayed requeue batch size'
+          ],
+          callback: ->(options) { ->(d) { options[:delayed_requeue_batch_size] = d } }
+        },
+        {
+          args: [
+            '--disable-delayed-requeue-batches',
+            'Disable delayed requeue batches [DISABLE_DELAYED_REQUEUE_BATCHES]'
+          ],
+          callback: ->(options) { ->(d) { options[:disable_delayed_requeue_batches] = d } }
         }
       ].freeze
 

data/lib/resque/scheduler/configuration.rb

@@ -65,10 +65,23 @@ module Resque
         @app_name ||= environment['APP_NAME']
       end
 
+      # Batch size for requeueing delayed jobs.  If <= 1, this disables batching.
+      # Defaults to 100.
+      attr_writer :delayed_requeue_batch_size
+
       def delayed_requeue_batch_size
         @delayed_requeue_batch_size ||= \
-          ENV['DELAYED_REQUEUE_BATCH_SIZE'].to_i if environment['DELAYED_REQUEUE_BATCH_SIZE']
-        @delayed_requeue_batch_size ||= 100
+          Integer(environment.fetch('DELAYED_REQUEUE_BATCH_SIZE', '100'))
+      end
+
+      attr_writer :disable_delayed_requeue_batches
+
+      def disable_delayed_requeue_batches
+        if @disable_delayed_requeue_batches.nil?
+          to_bool(environment['DISABLE_DELAYED_REQUEUE_BATCHES'])
+        else
+          @disable_delayed_requeue_batches
+        end
       end
 
       # Amount of time in seconds to sleep between polls of the delayed

data/lib/resque/scheduler/delaying_extensions.rb

@@ -10,6 +10,10 @@ module Resque
       # for queueing.  Until timestamp is in the past, the job will
       # sit in the schedule list.
       def enqueue_at(timestamp, klass, *args)
+        if Resque::Scheduler::Util.active_job_class?(klass)
+          return enqueue_at_with_queue(nil, timestamp, klass, *args)
+        end
+
         validate(klass)
         enqueue_at_with_queue(
           queue_from_class(klass), timestamp, klass, *args
@@ -21,19 +25,29 @@ module Resque
       # timestamp has passed. It respects Resque.inline option, by
       # creating the job right away instead of adding to the queue.
       def enqueue_at_with_queue(queue, timestamp, klass, *args)
-        plugin.process_schedule_hooks(klass, *args) do
-          if Resque.inline? || timestamp.to_i <= Time.now.to_i
-            # Just create the job and let resque perform it right away with
-            # inline.  If the class is a custom job class, call self#scheduled
-            # on it. This allows you to do things like
-            # Resque.enqueue_at(timestamp, CustomJobClass, :opt1 => val1).
-            # Otherwise, pass off to Resque.
-            if klass.respond_to?(:scheduled)
-              klass.scheduled(queue, klass.to_s, *args)
-            else
-              Resque.enqueue_to(queue, klass, *args)
-            end
+        if Resque::Scheduler::Util.active_job_class?(klass)
+          return klass.set(**{ wait_until: timestamp, queue: queue }.compact)
+                      .perform_later(*args)
+        end
+
+        if Resque.inline? || timestamp.to_i <= Time.now.to_i
+          # Just create the job and let resque perform it right away with
+          # inline.  If the class is a custom job class, call self#scheduled
+          # on it. This allows you to do things like
+          # Resque.enqueue_at(timestamp, CustomJobClass, :opt1 => val1).
+          # Otherwise, pass off to Resque.
+          #
+          # Note: schedule hooks are NOT called here because the job is not
+          # actually being added to the delayed queue.
+          if klass.respond_to?(:scheduled)
+            klass.scheduled(queue, klass.to_s, *args)
           else
+            Resque.enqueue_to(queue, klass, *args)
+          end
+        else
+          # Job is being added to the delayed queue, so we call the
+          # before_schedule and after_schedule hooks.
+          plugin.process_schedule_hooks(klass, *args) do
             delayed_push(timestamp, job_to_hash_with_queue(queue, klass, args))
           end
         end
@@ -83,11 +97,13 @@ module Resque
       # insertion time complexity is O(log(n)). Returns true if it's
       # the first job to be scheduled at that time, else false.
       def delayed_push(timestamp, item)
+        encoded_job = encode(item)
+
         # First add this item to the list for this timestamp
-        redis.rpush("delayed:#{timestamp.to_i}", encode(item))
+        redis.rpush("delayed:#{timestamp.to_i}", encoded_job)
 
         # Store the timestamps at with this item occurs
-        redis.sadd("timestamps:#{encode(item)}", ["delayed:#{timestamp.to_i}"])
+        redis.sadd("timestamps:#{encoded_job}", ["delayed:#{timestamp.to_i}"])
 
         # Now, add this timestamp to the zsets.  The score and the value are
         # the same since we'll be querying by timestamp, and we don't have
@@ -171,14 +187,14 @@ module Resque
       def enqueue_delayed(klass, *args)
         hash = job_to_hash(klass, args)
         remove_delayed(klass, *args).times do
-          Resque::Scheduler.enqueue_from_config(hash)
+          Resque::Scheduler.enqueue_from_config(hash, :delayed)
         end
       end
 
       def enqueue_delayed_with_queue(klass, queue, *args)
         hash = job_to_hash_with_queue(queue, klass, args)
         remove_delayed_in_queue(klass, queue, *args).times do
-          Resque::Scheduler.enqueue_from_config(hash)
+          Resque::Scheduler.enqueue_from_config(hash, :delayed)
         end
       end
 
@@ -261,12 +277,18 @@ module Resque
         count
       end
 
+      # Counts all jobs across all delayed timestamps.
+      # Uses pipelined LLEN calls in batches to avoid blocking the Redis thread
+      # for too long while being significantly faster than sequential calls.
       def count_all_scheduled_jobs
-        total_jobs = 0
-        Array(redis.zrange(:delayed_queue_schedule, 0, -1)).each do |ts|
-          total_jobs += redis.llen("delayed:#{ts}").to_i
+        timestamps = Array(redis.zrange(:delayed_queue_schedule, 0, -1))
+        return 0 if timestamps.empty?
+
+        timestamps.each_slice(10_000).sum do |batch|
+          redis.pipelined do |pipeline|
+            batch.each { |ts| pipeline.llen("delayed:#{ts}") }
+          end.sum
         end
-        total_jobs
       end
 
       # Discover if a job has been delayed.

data/lib/resque/scheduler/env.rb

@@ -30,18 +30,18 @@ module Resque
       def setup_backgrounding
         return unless options[:background]
 
-        # Need to set this here for conditional Process.daemon redirect of
-        # stderr/stdout to /dev/null
-        Resque::Scheduler.quiet = if options.key?(:quiet)
-                                    !!options[:quiet]
-                                  else
-                                    true
-                                  end
+        Resque::Scheduler.quiet = background_quiet?
 
         Process.daemon(true, !Resque::Scheduler.quiet)
         Resque.redis.reconnect
       end
 
+      def background_quiet?
+        return !!options[:quiet] if options.key?(:quiet)
+        return false if options.key?(:logfile)
+        !!options[:background]
+      end
+
       def setup_pid_file
         return unless options[:pidfile]
 
@@ -74,6 +74,14 @@ module Resque
           end
 
           c.verbose = !!options[:verbose] if options.key?(:verbose)
+
+          if options.key?(:delayed_requeue_batch_size)
+            c.delayed_requeue_batch_size = Integer(options[:delayed_requeue_batch_size])
+          end
+
+          if options.key?(:disable_delayed_requeue_batches)
+            c.disable_delayed_requeue_batches = !!options[:disable_delayed_requeue_batches]
+          end
         end
       end
       # rubocop:enable Metrics/AbcSize

data/lib/resque/scheduler/plugin.rb

@@ -3,6 +3,8 @@
 module Resque
   module Scheduler
     module Plugin
+      ENQUEUE_HOOKS = %i[delayed recurring].freeze
+
       def self.process_schedule_hooks(klass, *args)
         # the documentation states that if any before_schedule hook returns
         # false, the process should not be enqueued
@@ -12,6 +14,32 @@ module Resque
         run_after_schedule_hooks(klass, *args)
       end
 
+      def self.process_recurring_hooks(klass, *args)
+        return unless run_before_recurring_hooks(klass, *args)
+
+        enqueued = yield
+        run_after_recurring_hooks(klass, *args) if enqueued
+        enqueued
+      end
+
+      def self.validate_enqueue_hooks(hooks)
+        return if hooks.nil? || ENQUEUE_HOOKS.include?(hooks)
+
+        raise ArgumentError, "unknown hooks: #{hooks.inspect}"
+      end
+
+      def self.process_enqueue_hooks(hooks, klass, *args, &block)
+        case hooks
+        when :delayed
+          run_before_delayed_enqueue_hooks(klass, *args)
+          yield
+        when :recurring
+          process_recurring_hooks(klass, *args, &block)
+        else
+          yield
+        end
+      end
+
       def self.hooks(job, pattern)
         job.methods.grep(/^#{pattern}/).sort
       end
@@ -35,6 +63,14 @@ module Resque
       def self.run_after_schedule_hooks(klass, *args)
         run_hooks(klass, 'after_schedule', *args)
       end
+
+      def self.run_before_recurring_hooks(klass, *args)
+        run_hooks(klass, 'before_recurring', *args)
+      end
+
+      def self.run_after_recurring_hooks(klass, *args)
+        run_hooks(klass, 'after_recurring', *args)
+      end
     end
   end
 end

data/lib/resque/scheduler/railtie.rb

@@ -0,0 +1,11 @@
+require 'resque/scheduler/server'
+
+module Resque
+  module Scheduler
+    class Railtie < Rails::Railtie
+      rake_tasks do
+        require 'resque/scheduler/tasks'
+      end
+    end
+  end
+end

data/lib/resque/scheduler/server/views/delayed_timestamp.erb

@@ -12,7 +12,7 @@
   <% jobs = resque.delayed_timestamp_peek(timestamp, start, 20) %>
   <% jobs.each do |job| %>
     <tr>
-      <td class='class'><%= job['class'] %></td>
+      <td class='class'><%= h job['class'] %></td>
       <td class='args'><%= h show_job_arguments(job['args']) %></td>
     </tr>
   <% end %>

data/lib/resque/scheduler/server/views/requeue-params.erb

@@ -1,4 +1,4 @@
-<h1><%= @job_name %></h1>
+<h1><%= h @job_name %></h1>
 
 <p class='intro'>
    This job requires parameters:
@@ -10,14 +10,14 @@
   <% value ||= {} %>
     <tr>
       <td>
-        <%= key %>
+        <%= h key %>
         <% if value['description'] || value[:description] %>
-          <span style="border-bottom:1px dotted;" title="<%=value ['description'] || value[:description] %>">(?)</span>
+          <span style="border-bottom:1px dotted;" title="<%= h(value['description'] || value[:description]) %>">(?)</span>
         <% end %>:
       </td>
-      <td><input type="text" name="<%= key %>" value="<%= value['default'] || value[:default] %>"></td>
+      <td><input type="text" name="<%= h key %>" value="<%= h(value['default'] || value[:default]) %>"></td>
   <% end %>
   </table>
-  <input type="hidden" name="job_name" value="<%= @job_name %>">
+  <input type="hidden" name="job_name" value="<%= h @job_name %>">
   <input type="submit" value="Queue now">
 </form>

data/lib/resque/scheduler/server/views/scheduler.erb

@@ -4,8 +4,8 @@
   The list below contains all scheduled jobs.  Click "Queue now" to queue
   a job immediately.
   <br/> Server local time: <%= Time.now %>
-  <br/> Server Environment: <%= Resque::Scheduler.env %>
-  <br/> Current master: <%= Resque.redis.get(Resque::Scheduler.master_lock.key) %>
+  <br/> Server Environment: <%= h Resque::Scheduler.env %>
+  <br/> Current master: <%= h Resque.redis.get(Resque::Scheduler.master_lock.key) %>
 </p>
 <p class='intro'>
   The highlighted jobs are skipped for current environment.

data/lib/resque/scheduler/server/views/search.erb

@@ -22,13 +22,13 @@
         <td style="padding-top: 12px; padding-bottom: 2px; width: 10px">
           <form action="<%= u "/delayed/cancel_now" %>" method="post">
             <input type="hidden" name="timestamp" value="<%= job['timestamp'].to_i %>">
-            <input type="hidden" name="klass" value="<%= job['class'] %>">
+            <input type="hidden" name="klass" value="<%= h job['class'] %>">
             <input type="hidden" name="args" value="<%= h(Resque.encode job['args']) %>">
             <input type="submit" value="Cancel Job">
           </form>
         </td>
         <td class='args'><%= format_time(Time.at(job['timestamp'])) %></td>
-        <td class='class'><%= job['class'] %></td>
+        <td class='class'><%= h job['class'] %></td>
         <td class='args'><%= h job['args'].inspect %></td>
       </tr>
   <% end %>
@@ -44,8 +44,8 @@
   </tr>
   <% queued.each do |job| %>
   <tr>
-    <td class='class'><%= job['queue'] %></td>
-    <td class='class'><%= job['class'] %></td>
+    <td class='class'><%= h job['queue'] %></td>
+    <td class='class'><%= h job['class'] %></td>
     <td class='args'><%= h job['args'].inspect %></td>
   </tr>
   <% end %>
@@ -61,8 +61,8 @@
   </tr>
   <% working.each do |job| %>
   <tr>
-    <td class='class'><%= job['queue'] %></td>
-    <td class='class'><%= job['class'] %></td>
+    <td class='class'><%= h job['queue'] %></td>
+    <td class='class'><%= h job['class'] %></td>
     <td class='args'><%= h job['args'].inspect %></td>
   </tr>
   <% end %>

data/lib/resque/scheduler/server/views/search_form.erb

@@ -1,4 +1,6 @@
 <form method="POST" action="<%= u 'delayed/search' %>">
+  <input type='checkbox' id='search_args' name='search_args' value="checked" <%= 'checked' if params[:search_args] == 'checked' %>/>
+  <label for="search_args"> Search Args?</label><br>
   <input type='input' name='search' value="<%= h params[:search] %>"/>
   <input type='submit' value='Search'/>
 </form>

data/lib/resque/scheduler/server.rb

@@ -48,7 +48,7 @@ module Resque
           if @parameters
             erb scheduler_template('requeue-params')
           else
-            Resque::Scheduler.enqueue_from_config(config)
+            Resque::Scheduler.enqueue_from_config(config, :recurring)
             redirect u('/overview')
           end
         end
@@ -68,7 +68,7 @@ module Resque
 
           # Insert the args hash into config and queue the resque job
           config = config.merge('args' => config_args)
-          Resque::Scheduler.enqueue_from_config(config)
+          Resque::Scheduler.enqueue_from_config(config, :recurring)
           redirect u('/overview')
         end
 
@@ -99,7 +99,8 @@ module Resque
         end
 
         def delayed_search
-          @jobs = find_job(params[:search])
+          field = params[:search_args] == 'checked' ? 'args' : 'class'
+          @jobs = find_job(params[:search], field)
           erb scheduler_template('search')
         end
 
@@ -153,21 +154,21 @@ module Resque
           )
         end
 
-        def find_job(worker)
-          worker = worker.downcase
-          results = working_jobs_for_worker(worker)
+        def find_job(term, field = 'class')
+          term = term.downcase
+          matches = ->(job) { job[field].to_s.downcase.include?(term) }
+          results = working_jobs_matching(matches)
 
-          dels = delayed_jobs_for_worker(worker)
+          dels = delayed_jobs_for_worker(term)
           results += dels.select do |j|
-            j['class'].downcase.include?(worker) &&
-              j.merge!('where_at' => 'delayed')
+            matches.call(j) && j.merge!('where_at' => 'delayed')
           end
 
           Resque.queues.each do |queue|
             queued = Resque.peek(queue, 0, Resque.size(queue))
             queued = [queued] unless queued.is_a?(Array)
             results += queued.select do |j|
-              j['class'].downcase.include?(worker) &&
+              matches.call(j) &&
                 j.merge!('queue' => queue, 'where_at' => 'queued')
             end
           end
@@ -187,13 +188,13 @@ module Resque
 
         def schedule_interval_every(every)
           every = [*every]
-          s = 'every: ' << every.first
+          s = 'every: ' << "#{every.first}#{'s' if every.first.is_a?(Numeric)}"
 
           return s unless every.length > 1
 
           s << ' ('
           meta = every.last.map do |key, value|
-            "#{key.to_s.tr('_', ' ')} #{value}"
+            "#{key.to_s.tr('_', ' ')} #{value}#{'s' if value.is_a?(Numeric)}"
           end
           s << meta.join(', ') << ')'
         end
@@ -228,12 +229,11 @@ module Resque
 
         private
 
-        def working_jobs_for_worker(worker)
+        def working_jobs_matching(matches)
           [].tap do |results|
             working = [*Resque.working]
             work = working.select do |w|
-              w.job && w.job['payload'] &&
-                w.job['payload']['class'].downcase.include?(worker)
+              w.job && w.job['payload'] && matches.call(w.job['payload'])
             end
             work.each do |w|
               results += [

data/lib/resque/scheduler/util.rb

@@ -34,6 +34,11 @@ module Resque
       def self.classify(dashed_word)
         dashed_word.split('-').map(&:capitalize).join
       end
+
+      def self.active_job_class?(klass)
+        defined?(::ActiveJob::Base) && klass.is_a?(Class) &&
+          klass < ::ActiveJob::Base
+      end
     end
   end
 end

data/lib/resque/scheduler/version.rb

@@ -2,6 +2,6 @@
 
 module Resque
   module Scheduler
-    VERSION = '5.0.0'.freeze
+    VERSION = '5.1.0'.freeze
   end
 end

data/lib/resque/scheduler.rb

@@ -1,6 +1,6 @@
 # vim:fileencoding=utf-8
 
-require 'redis/errors'
+require 'redis'
 require 'rufus/scheduler'
 require_relative 'scheduler/configuration'
 require_relative 'scheduler/locking'
@@ -8,6 +8,8 @@ require_relative 'scheduler/logger_builder'
 require_relative 'scheduler/signal_handling'
 require_relative 'scheduler/failure_handler'
 
+require 'resque/scheduler/railtie' if defined?(Rails::Railtie)
+
 module Resque
   module Scheduler
     autoload :Cli, 'resque/scheduler/cli'
@@ -49,6 +51,7 @@ module Resque
         $stderr.sync = true
 
         was_master = nil
+        schedule_loaded = false
 
         begin
           @th = Thread.current
@@ -61,8 +64,14 @@ module Resque
               if am_master != was_master
                 procline am_master ? 'Master scheduler' : 'Child scheduler'
 
-                # Load schedule because changed
-                reload_schedule!
+                # The first pass always loads the schedule - load_schedule!
+                # reads am_master, so it cannot run before the check above.
+                # After that, only a dynamic schedule can have changed while
+                # we were not master.
+                if dynamic || !schedule_loaded
+                  reload_schedule!
+                  schedule_loaded = true
+                end
               end
 
               if am_master
@@ -144,12 +153,17 @@ module Resque
           interval_defined = false
           interval_types = %w(cron every)
           interval_types.each do |interval_type|
-            next unless !config[interval_type].nil? && !config[interval_type].empty?
+            next unless !config[interval_type].nil? && !config[interval_type].to_s.empty?
             args = optionizate_interval_value(config[interval_type])
             args = [args, nil, job: true] if args.is_a?(::String)
 
-            job = rufus_scheduler.send(interval_type, *args) do
-              enqueue_recurring(name, config)
+            begin
+              job = rufus_scheduler.send(interval_type, *args) do
+                enqueue_recurring(name, config)
+              end
+            rescue ArgumentError => e
+              log_error "Invalid #{interval_type} schedule for #{name}: #{e.message} - skipping"
+              return
             end
             @scheduled_jobs[name] = job
             interval_defined = true
@@ -198,31 +212,42 @@ module Resque
 
         if item
           log "queuing #{item['class']} [delayed]"
-          enqueue(item)
+          enqueue(item, :delayed)
         end
 
         item
       end
 
+      def batch_delayed_items?
+        !disable_delayed_requeue_batches && delayed_requeue_batch_size > 1
+      end
+
       # Enqueues all delayed jobs for a timestamp
       def enqueue_delayed_items_for_timestamp(timestamp)
         count = 0
-        batch_size = delayed_requeue_batch_size
-        actual_batch_size = nil
+        batch_size = batch_delayed_items? ? delayed_requeue_batch_size : 1
 
-        log "Processing delayed items for timestamp #{timestamp}, in batches of #{batch_size}"
+        message = "Processing delayed items for timestamp #{timestamp}"
+        message += ", in batches of #{batch_size}" if batch_delayed_items?
+        log message
 
         loop do
+          actual_batch_size = 0
+
           handle_shutdown do
             # Continually check that it is still the master
             if am_master
-              actual_batch_size = enqueue_items_in_batch_for_timestamp(timestamp,
-                                                                       batch_size)
+              if batch_delayed_items?
+                actual_batch_size = enqueue_items_in_batch_for_timestamp(timestamp, batch_size)
+                log "queued batch of #{actual_batch_size} jobs" if actual_batch_size != -1
+              else
+                item = enqueue_next_item(timestamp)
+                actual_batch_size = item.nil? ? 0 : 1
+              end
             end
           end
 
           count += actual_batch_size
-          log "queued #{count} jobs" if actual_batch_size != -1
 
           # continue processing until there are no more items in this
           # timestamp. If we don't have a full batch, this is the last one.
@@ -231,7 +256,7 @@ module Resque
           break if actual_batch_size < batch_size
         end
 
-        log "finished queueing #{count} total jobs for timestamp #{timestamp}" if count != -1
+        log "finished queueing #{count} total jobs for timestamp #{timestamp}" if count > 0
       end
 
       def timestamp_key(timestamp)
@@ -255,7 +280,7 @@ module Resque
               pipeline.srem("timestamps:#{encoded_job}", timestamp_bucket_key)
 
               decoded_job = Resque.decode(encoded_job)
-              enqueue(decoded_job)
+              enqueue(decoded_job, :delayed)
             end
 
             pipeline.ltrim(timestamp_bucket_key, batch_size, -1)
@@ -282,8 +307,12 @@ module Resque
         encoded_jobs_to_requeue.count
       end
 
-      def enqueue(config)
-        enqueue_from_config(config)
+      # Enqueues a job like enqueue_from_config, but hands errors to the failure
+      # handler instead of raising them. Pass :delayed as hooks for a job that
+      # left the delayed queue or :recurring for a schedule entry to run the
+      # matching hooks.
+      def enqueue(config, hooks = nil)
+        enqueue_from_config(config, hooks)
       rescue => e
         Resque::Scheduler.failure_handler.on_enqueue_failure(config, e)
       end
@@ -294,8 +323,11 @@ module Resque
         exit if @shutdown
       end
 
-      # Enqueues a job based on a config hash
-      def enqueue_from_config(job_config)
+      # Enqueues a job based on a config hash. Pass :delayed as hooks for a job
+      # that left the delayed queue or :recurring for a schedule entry to run
+      # the matching hooks.
+      def enqueue_from_config(job_config, hooks = nil)
+        Resque::Scheduler::Plugin.validate_enqueue_hooks(hooks)
         args = job_config['args'] || job_config[:args]
 
         klass_name = job_config['class'] || job_config[:class]
@@ -306,9 +338,13 @@ module Resque
         end
 
         params = args.is_a?(Hash) ? [args] : Array(args)
-        queue = job_config['queue'] ||
-                job_config[:queue] ||
-                Resque.queue_from_class(klass)
+        queue = job_config['queue'] || job_config[:queue]
+
+        if Resque::Scheduler::Util.active_job_class?(klass)
+          return klass.set(**{ queue: queue }.compact).perform_later(*params)
+        end
+
+        queue ||= Resque.queue_from_class(klass)
         # Support custom job classes like those that inherit from
         # Resque::JobWithStatus (resque-status)
         job_klass = job_config['custom_job_class']
@@ -331,8 +367,7 @@ module Resque
           # for non-existent classes (for example: running scheduler in
           # one app that schedules for another.
           if Class === klass
-            Resque::Scheduler::Plugin.process_schedule_hooks(klass, *params) do
-              Resque::Scheduler::Plugin.run_before_delayed_enqueue_hooks(klass, *params)
+            Resque::Scheduler::Plugin.process_enqueue_hooks(hooks, klass, *params) do
               # If the class is a custom job class, call self#scheduled on it.
               # This allows you to do things like Resque.enqueue_at(timestamp,
               # CustomJobClass). Otherwise, pass off to Resque.
@@ -492,7 +527,7 @@ module Resque
       def enqueue_recurring(name, config)
         if am_master
           log! "queueing #{config['class']} (#{name})"
-          enqueue(config)
+          enqueue(config, :recurring)
           Resque.last_enqueued_at(name, Time.now.to_s)
         end
       end

data/resque-scheduler.gemspec

@@ -32,7 +32,7 @@ Gem::Specification.new do |spec|
   spec.license = 'MIT'
   spec.metadata['rubygems_mfa_required'] = 'true'
 
-  spec.required_ruby_version = '>= 3.0.0'
+  spec.required_ruby_version = '>= 3.2.0'
 
   spec.files = `git ls-files -z`.split("\0").reject do |f|
     f.match(%r{^(test|spec|features|examples|bin|tasks)/}) ||
@@ -43,6 +43,7 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = %w(lib)
 
+  spec.add_development_dependency 'activejob'
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'json'
   spec.add_development_dependency 'irb'
@@ -59,14 +60,12 @@ Gem::Specification.new do |spec|
 
   # We pin rubocop because new cops have a tendency to result in false-y
   # positives for new contributors, which is not a nice experience.
-  spec.add_development_dependency 'rubocop', '~> 0.80'
+  spec.add_development_dependency 'rubocop', '~> 1.91'
 
   spec.add_runtime_dependency 'base64', '~> 0.1'
   spec.add_runtime_dependency 'logger'
   spec.add_runtime_dependency 'mono_logger', '~> 1.0'
   spec.add_runtime_dependency 'redis', '>= 4.0'
   spec.add_runtime_dependency 'resque', '>= 3.0'
-  # rufus-scheduler v3.7 causes a failure in test/multi_process_test.rb
-  # rufus-scheduler v3.3 is missing a to_local method which fails tests
-  spec.add_runtime_dependency 'rufus-scheduler', '~> 3.2', '!= 3.3'
+  spec.add_runtime_dependency 'rufus-scheduler', '~> 3.9'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: resque-scheduler
 version: !ruby/object:Gem::Version
-  version: 5.0.0
+  version: 5.1.0
 platform: ruby
 authors:
 - Ben VandenBos
@@ -10,11 +10,24 @@ authors:
 - Dan Buch
 - Michael Bianco
 - Patrick Tulskie
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-01-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activejob
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -203,14 +216,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.80'
+        version: '1.91'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.80'
+        version: '1.91'
 - !ruby/object:Gem::Dependency
   name: base64
   requirement: !ruby/object:Gem::Requirement
@@ -287,20 +300,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
-    - - "!="
-      - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '3.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
-    - - "!="
-      - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '3.9'
 description: |2
       Light weight job scheduling on top of Resque.
       Adds methods enqueue_at/enqueue_in to schedule jobs in the future.
@@ -322,9 +329,6 @@ files:
 - ".devcontainer/devcontainer.json"
 - ".devcontainer/docker-compose.yml"
 - ".github/dependabot.yml"
-- ".github/funding.yml"
-- ".github/workflows/codeql-analysis.yml"
-- ".github/workflows/rubocop.yml"
 - ".github/workflows/ruby.yml"
 - AUTHORS.md
 - CHANGELOG.md
@@ -350,6 +354,7 @@ files:
 - lib/resque/scheduler/locking.rb
 - lib/resque/scheduler/logger_builder.rb
 - lib/resque/scheduler/plugin.rb
+- lib/resque/scheduler/railtie.rb
 - lib/resque/scheduler/scheduling_extensions.rb
 - lib/resque/scheduler/server.rb
 - lib/resque/scheduler/server/views/delayed.erb
@@ -369,7 +374,6 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -377,15 +381,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Light weight job scheduling on top of Resque
 test_files: []

data/.github/funding.yml

@@ -1,4 +0,0 @@
-# Docs for this file can be found here:
-# https://docs.github.com/en/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository
-
-github: ["iloveitaly"]

data/.github/workflows/codeql-analysis.yml

@@ -1,59 +0,0 @@
-name: "CodeQL"
-
-on:
-  push:
-    branches: [ master, '*-stable' ]
-  pull_request:
-    # The branches below must be a subset of the branches above
-    branches: [ master ]
-  schedule:
-    - cron: '44 16 * * 6'
-
-jobs:
-  analyze:
-    name: Analyze
-    runs-on: ubuntu-latest
-    permissions:
-      actions: read
-      contents: read
-      security-events: write
-
-    strategy:
-      fail-fast: false
-      matrix:
-        language: [ 'ruby' ]
-        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
-        # Learn more about CodeQL language support at https://git.io/codeql-language-support
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v4
-
-    # Initializes the CodeQL tools for scanning.
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v3
-      with:
-        languages: ${{ matrix.language }}
-        # If you wish to specify custom queries, you can do so here or in a config file.
-        # By default, queries listed here will override any specified in a config file.
-        # Prefix the list here with "+" to use these queries and those in the config file.
-        # queries: ./path/to/local/query, your-org/your-repo/queries@main
-
-    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
-    # If this step fails, then you should remove it and run the build manually (see below)
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v3
-
-    # ℹ️ Command-line programs to run using the OS shell.
-    # 📚 https://git.io/JvXDl
-
-    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
-    #    and modify them (or add more) to build your code if your project
-    #    uses a compiled language
-
-    #- run: |
-    #   make bootstrap
-    #   make release
-
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v3

data/.github/workflows/rubocop.yml

@@ -1,27 +0,0 @@
-name: Rubocop
-
-on:
-  push:
-    branches: [master]
-  pull_request:
-    branches: [master]
-
-jobs:
-  rubocop:
-    name: Rubocop
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        ruby: [
-            3.4
-        ]
-
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - name: Ruby linter
-        run: bundle exec rubocop