whenever 1.1.2 → 1.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6e3f0d94253d0ac6d5a7f856afeb690b25f83a551e74581ebcc3cb0320855bc
-  data.tar.gz: 8d8ccccb89a2d7e4c5dd8d6744314888c88928a0bf7b6b3ed2bc7e195cae4290
+  metadata.gz: 9797821aa7a21784824362ac3e7c4281cbbbf70ab36921f40670f15a73912be5
+  data.tar.gz: b78b898fda4aa8817c97447b584fea0e55de9351f2726ccbf88f834250262bdc
 SHA512:
-  metadata.gz: f7942baf77e31bb83add51eea178e5ff11d724196a23cc45a47668813acb8ce428f1ab27ca806544ee935e67b8d164a6586e0a6bfda8eb33afb2ef0ea33c88d8
-  data.tar.gz: 30691f3aa03c58df894d3d516c21fedd9a6a3d23563ebaa9d267977b59a822c37071f4fc3663aae115f008865f426a899ce436badbb6883643aaa24b7e2a146c
+  metadata.gz: 3be670ce4d4eefb9ac290d8d48f6b8c755a763bf1ba00c22350f7fb138ea47046998ce799b426a79f5342da11ac854b7ace890d72bb998c9689c588039b75540
+  data.tar.gz: a061b6512241f9d45d5be373889f7423185abcb70431c5daa429af75249cc199f5f4db1ed0cc66c414d89b659640ab1ef58dc7fb1363f952febb59a020c83ee3

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,5 +1,17 @@
 ### unreleased
 
+### 1.1.4 / October 21, 2026
+
+* Don't ship tests in the gem https://github.com/javan/whenever/pull/877
+
+### 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
 
@@ -11,7 +23,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 +35,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 +173,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.4'
 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/whenever.gemspec

@@ -20,8 +20,7 @@ Gem::Specification.new do |spec|
   spec.metadata["changelog_uri"] = "https://github.com/javan/whenever/blob/main/CHANGELOG.md"
   spec.metadata["rubygems_mfa_required"] = "true"
 
-  spec.files         = `git ls-files`.split("\n")
-  spec.test_files    = `git ls-files -- test/{functional,unit}/*`.split("\n")
+  spec.files         = `git ls-files`.split("\n").reject { |f| f.start_with?("test/") }
   spec.executables   = spec.files.grep(%r{\Abin/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: whenever
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.4
 platform: ruby
 authors:
 - Javan Makhmali
@@ -65,27 +65,13 @@ 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
 - lib/whenever/output_redirection.rb
 - lib/whenever/setup.rb
 - lib/whenever/version.rb
-- test/functional/command_line_test.rb
-- test/functional/output_at_test.rb
-- test/functional/output_default_defined_jobs_test.rb
-- test/functional/output_defined_job_test.rb
-- test/functional/output_description_test.rb
-- 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_redirection_test.rb
-- test/test_case.rb
-- test/test_helper.rb
-- test/unit/capistrano_support_test.rb
-- test/unit/cron_test.rb
-- test/unit/executable_test.rb
-- test/unit/job_test.rb
 - whenever.gemspec
 homepage: https://github.com/javan/whenever
 licenses:
@@ -109,20 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Cron jobs in ruby.
-test_files:
-- test/functional/command_line_test.rb
-- test/functional/output_at_test.rb
-- test/functional/output_default_defined_jobs_test.rb
-- test/functional/output_defined_job_test.rb
-- test/functional/output_description_test.rb
-- 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_redirection_test.rb
-- test/unit/capistrano_support_test.rb
-- test/unit/cron_test.rb
-- test/unit/executable_test.rb
-- test/unit/job_test.rb
+test_files: []