whenever 1.1.2 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6e3f0d94253d0ac6d5a7f856afeb690b25f83a551e74581ebcc3cb0320855bc
-  data.tar.gz: 8d8ccccb89a2d7e4c5dd8d6744314888c88928a0bf7b6b3ed2bc7e195cae4290
+  metadata.gz: 85714fb8b50231a67eca8db2f67211fc11e8bb07bbb76db5333882676f626802
+  data.tar.gz: 9523c1ec86b34bd8fcd9244ebbc37206857ef25bdcce6cbb661769e9231d3ed5
 SHA512:
-  metadata.gz: f7942baf77e31bb83add51eea178e5ff11d724196a23cc45a47668813acb8ce428f1ab27ca806544ee935e67b8d164a6586e0a6bfda8eb33afb2ef0ea33c88d8
-  data.tar.gz: 30691f3aa03c58df894d3d516c21fedd9a6a3d23563ebaa9d267977b59a822c37071f4fc3663aae115f008865f426a899ce436badbb6883643aaa24b7e2a146c
+  metadata.gz: bd84f4e82fcd6aff274fef804ca4fd2e834d6817778fd09d56287a013039005e1ecaeb12e8fde657502709bcabcd8dc31bdd0d99cd163edefe1d0b8889d2a78d
+  data.tar.gz: 59728cc54eae8cd88fe0d911ff6bb2a5571fdc0f257dc93ab8564c3d7795f7583aece8c21eede62ae6b99b5a264c3b4ece7e222dac77f3a2b1401f3f3237605b

data/.github/workflows/ci.yml

@@ -3,6 +3,8 @@ on:
   pull_request:
   push:
     branches: [ main ]
+permissions:
+  contents: read
 jobs:
   test:
     runs-on: ${{ matrix.os }}
@@ -23,7 +25,7 @@ jobs:
           - os: macos-15-intel
             ruby-version: '2.5'
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         name: Set up Ruby ${{ matrix.ruby-version }}
       - uses: ruby/setup-ruby@v1
         env:
@@ -74,7 +76,7 @@ jobs:
     env:
       BUNDLE_GEMFILE: ${{ github.workspace }}/gemfiles/activesupport${{ matrix.rails-version }}.gemfile
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         name: Set up Ruby ${{ matrix.ruby-version }}
       - uses: ruby/setup-ruby@v1
         with:

data/CHANGELOG.md

@@ -1,6 +1,15 @@
 ### unreleased
 
 
+### 1.1.3 / September 15, 2026
+
+* Add support for sequential job definitions https://github.com/javan/whenever/pull/854
+
+* CI: Bump actions/checkout from 6 to 7 https://github.com/javan/whenever/pull/876
+
+* CI: Restrict GitHub Actions workflow permissions to contents: read https://github.com/javan/whenever/pull/875
+
+
 ### 1.1.2 / January 18, 2026
 
 * Add description as comment in crontab https://github.com/javan/whenever/pull/776
@@ -11,7 +20,7 @@
 
 * CI: Use macos-15-intel instead of macos-13 for Ruby 2.4 and 2.5 https://github.com/javan/whenever/pull/871
 
-### 1.1.1 / Dec 8, 2025
+### 1.1.1 / December 8, 2025
 
 * job_list `.respond_to?` updated to an instance method https://github.com/javan/whenever/pull/830
 
@@ -23,7 +32,7 @@
 
 * Require MFA for gem releases https://github.com/javan/whenever/pull/867
 
-### 1.1.0 / Nov 21, 2025
+### 1.1.0 / November 21, 2025
 
 * Splat whenever_roles when passing to roles https://github.com/javan/whenever/pull/777
 
@@ -161,7 +170,7 @@
 * Process params in job templates. [Austin Ziegler]
 
 
-### 0.8.4 / July 22, 2012
+### 0.8.4 / July 22, 2013
 
 * Don't require schedule file when clearing. [Javan Makhmali]
 

data/README.md

@@ -59,6 +59,14 @@ every 3.hours do # 1.minute 1.day 1.week 1.month 1.year is also supported
   command "/usr/bin/my_great_command"
 end
 
+every 3.hours, sequential: true do
+  # Jobs in this block that don't set their own sequence will default to run in the same sequence (not in parallel)
+  runner "MyModel.some_process", halt_sequence_on_failure: true # If this job fails, subsequent jobs will not run (defaults to false)
+  rake "my:rake:task"
+  command "/usr/bin/my_great_command", sequence: nil # This job runs in parallel with other jobs that are not part of a sequence
+  runner "MyModel.task_to_run_at_four_thirty_in_the_morning", sequence: 'other' # This job runs sequentially with other jobs in the sequence called 'other'
+end
+
 every 1.day, at: '4:30 am' do
   runner "MyModel.task_to_run_at_four_thirty_in_the_morning"
 end

data/lib/whenever/job.rb

@@ -2,7 +2,7 @@ require 'shellwords'
 
 module Whenever
   class Job
-    attr_reader :at, :roles, :mailto, :description
+    attr_reader :at, :roles, :mailto, :description, :sequence, :halt_sequence_on_failure
 
     def initialize(options = {})
       @options = options
@@ -10,6 +10,8 @@ module Whenever
       @template                         = options.delete(:template)
       @mailto                           = options.fetch(:mailto, :default_mailto)
       @job_template                     = options.delete(:job_template) || ":job"
+      @sequence                         = options.delete(:sequence)
+      @halt_sequence_on_failure         = options.delete(:halt_sequence_on_failure)
       @roles                            = Array(options.delete(:roles))
       @description                      = options.delete(:description)
       @options[:output]                 = options.has_key?(:output) ? Whenever::Output::Redirection.new(options[:output]).to_s : ''

data/lib/whenever/job_list.rb

@@ -48,6 +48,12 @@ module Whenever
     def every(frequency, options = {})
       @current_time_scope = frequency
       @options = options
+
+      if @options[:sequential]
+        @default_sequence_id ||= 0
+        @options[:sequence] ||= "default_sequence_#{@default_sequence_id += 1}"
+      end
+
       yield
     end
 
@@ -138,10 +144,17 @@ module Whenever
     def cron_jobs_of_time(time, jobs)
       shortcut_jobs, regular_jobs = [], []
 
+      filtered_jobs = jobs.select do |job|
+        roles.empty? || roles.any? { |r| job.has_role?(r) }
+      end
+
+      grouped_jobs = filtered_jobs.group_by(&:sequence)
+      grouped_jobs.each do |sequence, jobs|
+        grouped_jobs[sequence] = JobSequence.new(jobs) if sequence
+      end
+      jobs = grouped_jobs.values.flatten
+
       jobs.each do |job|
-        next unless roles.empty? || roles.any? do |r|
-          job.has_role?(r)
-        end
         Whenever::Output::Cron.output(time, job, :chronic_options => @chronic_options) do |cron|
           cron << "\n\n"
           cron = (job.description.strip + "\n").gsub(/^(.*)$/, '# \1') + cron unless job.description.to_s.empty?

data/lib/whenever/job_sequence.rb

@@ -0,0 +1,36 @@
+require 'shellwords'
+
+module Whenever
+  class JobSequence
+    attr_reader :at, :roles, :mailto, :description
+
+    def initialize(jobs, options = {})
+      validate!(jobs)
+
+      @jobs        = jobs
+      @options     = options
+      @at          = options.fetch(:at, primary_job.at)
+      @mailto      = options.fetch(:mailto, primary_job.mailto || :default_mailto)
+      @roles       = Array(options.delete(:roles), *primary_job.roles)
+      @description = options.fetch(:description) { @jobs.map { |job| job.description.to_s.strip }.reject(&:empty?).uniq.join("\n") }
+    end
+
+    def output
+      @jobs.map { |job| [job.output, job.halt_sequence_on_failure ?  ' && ' : ' ; '] }.flatten[0..-2].join
+    end
+
+    def has_role?(role)
+      roles.empty? || roles.include?(role)
+    end
+
+  private
+
+    def primary_job
+      @jobs.first
+    end
+
+    def validate!(jobs)
+      raise ArgumentError, "Jobs in a sequence don't support different `at` values" if jobs.map(&:at).uniq.count > 1
+    end
+  end
+end

data/lib/whenever/version.rb

@@ -1,3 +1,3 @@
 module Whenever
-  VERSION = '1.1.2'
+  VERSION = '1.1.3'
 end

data/lib/whenever.rb

@@ -2,6 +2,7 @@ require "whenever/version"
 require 'whenever/numeric'
 require 'whenever/numeric_seconds'
 require 'whenever/job_list'
+require 'whenever/job_sequence'
 require 'whenever/job'
 require 'whenever/command_line'
 require 'whenever/cron'

data/test/functional/output_jobs_with_sequence_test.rb

@@ -0,0 +1,187 @@
+require 'test_helper'
+
+class OutputJobsWithSequenceTest < Whenever::TestCase
+  test "defined jobs with a sequence argument specified per-job" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours do
+        command "blahblah", sequence: 'backups'
+        command "foofoo", sequence: 'backups'
+        command "barbar"
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'barbar'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a sequence argument specified on the group" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah"
+        command "foofoo"
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a sequence argument and a job that halts the sequence on failure" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah", halt_sequence_on_failure: true
+        command "foofoo"
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah' && /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a sequences specified on the group and jobs" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah"
+        command "barbar", sequence: nil
+        command "foofoo"
+        command "bazbaz", sequence: 'bees'
+        command "buzzbuzz", sequence: 'bees'
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'barbar'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'bazbaz' ; /bin/bash -l -c 'buzzbuzz'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a multiple groups with sequences specified on the group and jobs" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah"
+        command "barbar", sequence: nil
+        command "bazbaz", sequence: 'bees'
+      end
+
+      every 2.hours, sequence: 'backups' do
+        command "foofoo"
+        command "buzzbuzz", sequence: 'bees'
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'barbar'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'bazbaz' ; /bin/bash -l -c 'buzzbuzz'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a multiple groups with sequences specified on the group and jobs" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah"
+        command "barbar", sequence: nil
+        command "bazbaz", sequence: 'bees'
+      end
+
+      every 3.hours, sequence: 'backups' do
+        command "foofoo"
+        command "buzzbuzz", sequence: 'bees'
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'barbar'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'bazbaz'", output_without_empty_line.shift
+    assert_equal three_hours + " /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+    assert_equal three_hours + " /bin/bash -l -c 'buzzbuzz'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a multiple groups with sequences specified on the group and jobs" do
+    assert_raises ArgumentError do
+      Whenever.cron \
+      <<-file
+        every 2.hours, sequence: 'backups' do
+          command "blahblah", at: 1
+          command "barbar", at: 2
+        end
+      file
+    end
+  end
+
+  test "defined jobs with a sequence argument and a description on the group" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups', description: "Nightly backups" do
+        command "blahblah"
+        command "foofoo"
+      end
+    file
+
+    assert_match "# Nightly backups\n" + two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output
+  end
+
+  test "defined jobs with a sequence argument and a description on each job" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah", description: "Dump the database"
+        command "foofoo", description: "Upload the dump"
+      end
+    file
+
+    assert_match "# Dump the database\n# Upload the dump\n" + two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output
+  end
+
+  test "defined jobs with a sequence argument and descriptions padded with whitespace" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequence: 'backups' do
+        command "blahblah", description: "  Dump the database  "
+        command "foofoo", description: "  Upload the dump  "
+      end
+    file
+
+    assert_match "# Dump the database\n# Upload the dump\n" + two_hours, output
+  end
+
+  def three_hours
+    "0 0,3,6,9,12,15,18,21 * * *"
+  end
+end
+
+class OutputJobsWithSequentialTest < Whenever::TestCase
+  test "defined jobs with a sequential argument" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequential: true do
+        command "blahblah"
+        command "foofoo"
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah' ; /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+  end
+
+  test "defined jobs with a sequential argument" do
+    output = Whenever.cron \
+    <<-file
+      every 2.hours, sequential: true do
+        command "blahblah"
+        command "foofoo", sequence: false
+      end
+    file
+
+    output_without_empty_line = lines_without_empty_line(output.lines)
+    assert_equal two_hours + " /bin/bash -l -c 'blahblah'", output_without_empty_line.shift
+    assert_equal two_hours + " /bin/bash -l -c 'foofoo'", output_without_empty_line.shift
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: whenever
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.3
 platform: ruby
 authors:
 - Javan Makhmali
@@ -65,6 +65,7 @@ files:
 - lib/whenever/cron.rb
 - lib/whenever/job.rb
 - lib/whenever/job_list.rb
+- lib/whenever/job_sequence.rb
 - lib/whenever/numeric.rb
 - lib/whenever/numeric_seconds.rb
 - lib/whenever/os.rb
@@ -79,6 +80,7 @@ files:
 - test/functional/output_env_test.rb
 - test/functional/output_jobs_for_roles_test.rb
 - test/functional/output_jobs_with_mailto_test.rb
+- test/functional/output_jobs_with_sequence_test.rb
 - test/functional/output_redirection_test.rb
 - test/test_case.rb
 - test/test_helper.rb
@@ -109,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Cron jobs in ruby.
 test_files:
@@ -121,6 +123,7 @@ test_files:
 - test/functional/output_env_test.rb
 - test/functional/output_jobs_for_roles_test.rb
 - test/functional/output_jobs_with_mailto_test.rb
+- test/functional/output_jobs_with_sequence_test.rb
 - test/functional/output_redirection_test.rb
 - test/unit/capistrano_support_test.rb
 - test/unit/cron_test.rb