whenever 0.9.7 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 9ec69e7c581dc0a3b78c99dc92d7ba20603fe314
-  data.tar.gz: 02fc72439569835cce71da0fc186ed48568ed1e2
+SHA256:
+  metadata.gz: dc5ff14e6e9d357583f5e20d31fafbcf2dfe3aea8ac756cf9103f51504674e9a
+  data.tar.gz: 446e8398b741a1a9a7ee262b3542efb107d1453259083fef03ea50726227d7dd
 SHA512:
-  metadata.gz: 732ee6e0a5d38ed8f323e814e2e6243306a5c2e84b44d5ce8f05d2c0ef7bf7520341044892906c7ea6899a24a87e840285a001dc54e35a196414da06de42a607
-  data.tar.gz: 9bbf8365c6fd030b7ba465d06660f1bd84cb8593b957f4482676fa50c6daf684b2de91c98bb84907e2e62f2e493f22b76c1ccbb7dbd469072ebf937e5e12cf85
+  metadata.gz: 41f396515f594a4726bd9048783653b0b203e0beb4ea65f6b95faf508061d0fd064bec0a31bbcf6dad6a23f68ec4f3364ae6e8f160eb0539ec6073a6c4960242
+  data.tar.gz: 4fbe2b52fc350ee272d7d03638369b8a6443c1ed6e122be511b9ccf07881c1e559d63587153259343febc89db40aa45bc4ca45cf83af885fd618fd5668ddd1d2

data/.travis.yml

@@ -1,18 +1,21 @@
 language: ruby
-script: bundle exec rake
 
 before_install:
   - gem install bundler
-
+  - unset _JAVA_OPTIONS
 rvm:
-  - 1.9.3
-  - 2.0.0
-  - 2.1.0
-  - 2.2.0
-  - 2.3.0
-  - jruby
+  - 2.4.6
+  - 2.5.5
+  - 2.6.3
+  - jruby-9.2.6.0
 
 gemfile:
-  - Gemfile
   - gemfiles/activesupport4.1.gemfile
   - gemfiles/activesupport4.2.gemfile
+  - gemfiles/activesupport5.0.gemfile
+  - gemfiles/activesupport5.1.gemfile
+  - gemfiles/activesupport5.2.gemfile
+
+env:
+  global:
+    - JRUBY_OPTS=--debug

data/Appraisals

@@ -0,0 +1,19 @@
+appraise 'activesupport4.1' do
+  gem "activesupport", "~> 4.1.0"
+end
+
+appraise 'activesupport4.2' do
+  gem "activesupport", "~> 4.2.0"
+end
+
+appraise 'activesupport5.0' do
+  gem "activesupport", "~> 5.0.0"
+end
+
+appraise 'activesupport5.1' do
+  gem "activesupport", "~> 5.1.0"
+end
+
+appraise 'activesupport5.2' do
+  gem "activesupport", "~> 5.2.0beta2"
+end

data/CHANGELOG.md

@@ -1,4 +1,36 @@
-### develop
+### unreleased
+
+### 1.0.0 / Jun 13, 2019
+
+* First stable release per SemVer.
+
+* Removes support for versions of Ruby which are no longer supported by the Ruby project.
+
+### 0.11.0 / April 23, 2019
+
+* Add support for mapping Range objects to cron range syntax [Tim Craft](https://github.com/javan/whenever/pull/725)
+
+* Bugfix: Avoid modifying Capistrano `default_env` when setting the whenever environment. [ta1kt0me](https://github.com/javan/whenever/pull/728)
+
+* Enable to execute whenever's task independently without setting :release_path or :whenever_path [ta1kt0me](https://github.com/javan/whenever/pull/729)
+
+* Make error message clearer when parsing cron syntax fails due to a trailing space [ignisf](https://github.com/javan/whenever/pull/744)
+
+### 0.10.0 / November 19, 2017
+
+* Modify wheneverize to allow for the creating of 'config' directory when not present
+
+* Add --crontab-command to whenever binary for overriding the crontab command. [Martin Grandrath]
+
+* Allow setting the path within which Capistrano will execute whenever. [Samuel Johnson](https://github.com/javan/whenever/pull/619)
+
+* Allow the use of string literals for month and day-of-week in raw cron syntax.. [Potamianos Gregory](https://github.com/javan/whenever/pull/711)
+
+* Include Capistrano default environment variables when executing Whenever. [Karl Li](https://github.com/javan/whenever/pull/719)
+
+* Allow configuring an alternative schedule file in Capistrano. [Shinichi Okamoto](https://github.com/javan/whenever/pull/666)
+
+* Add customizing email recipient option with the MAILTO environment variable. [Chikahiro Tokoro](https://github.com/javan/whenever/pull/678)
 
 ### 0.9.7 / June 14, 2016
 

data/Gemfile

@@ -1,4 +1,4 @@
-source "http://rubygems.org"
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in whenever.gemspec
 gemspec

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2016 Javan Makhmali
+Copyright (c) 2017 Javan Makhmali
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/README.md

@@ -9,7 +9,7 @@ $ gem install whenever
 Or with Bundler in your Gemfile.
 
 ```ruby
-gem 'whenever', :require => false
+gem 'whenever', require: false
 ```
 
 ### Getting started
@@ -19,7 +19,7 @@ $ cd /apps/my-great-project
 $ wheneverize .
 ```
 
-This will create an initial `config/schedule.rb` file for you.
+This will create an initial `config/schedule.rb` file for you (as long as the config folder is already present in your project).
 
 ### The `whenever` command
 
@@ -34,28 +34,39 @@ This will simply show you your `schedule.rb` file converted to cron syntax. It d
 $ whenever --update-crontab
 ```
 
+Other commonly used options include:
+```sh
+$ whenever --user app # set a user as which to install the crontab
+$ whenever --load-file config/my_schedule.rb # set the schedule file
+$ whenever --crontab-command 'sudo crontab' # override the crontab command
+```
+
 You can list installed cron jobs using `crontab -l`.
 
-Run `whenever --help` for a complete list of options for selecting the schedule to use, setting variables in the schedule, selecting a user as which to install the crontab, etc.
+Run `whenever --help` for a complete list of options for selecting the schedule to use, setting variables in the schedule, etc.
 
 ### Example schedule.rb file
 
 ```ruby
-every 3.hours do
+every 3.hours do # 1.minute 1.day 1.week 1.month 1.year is also supported
   runner "MyModel.some_process"
   rake "my:rake:task"
   command "/usr/bin/my_great_command"
 end
 
-every 1.day, :at => '4:30 am' do
+every 1.day, at: '4:30 am' do
   runner "MyModel.task_to_run_at_four_thirty_in_the_morning"
 end
 
+every 1.day, at: ['4:30 am', '6:00 pm'] do
+  runner "Mymodel.task_to_run_in_two_times_every_day"
+end
+
 every :hour do # Many shortcuts available: :hour, :day, :month, :year, :reboot
   runner "SomeModel.ladeeda"
 end
 
-every :sunday, :at => '12pm' do # Use any day of the week or :weekend, :weekday
+every :sunday, at: '12pm' do # Use any day of the week or :weekend, :weekday
   runner "Task.do_something_great"
 end
 
@@ -65,7 +76,7 @@ end
 
 # run this task only on servers with the :app role in Capistrano
 # see Capistrano roles section below
-every :day, :at => '12:20am', :roles => [:app] do
+every :day, at: '12:20am', roles: [:app] do
   rake "app_server:task"
 end
 ```
@@ -80,7 +91,7 @@ For example:
 job_type :awesome, '/usr/local/bin/awesome :task :fun_level'
 
 every 2.hours do
-  awesome "party", :fun_level => "extreme"
+  awesome "party", fun_level: "extreme"
 end
 ```
 
@@ -113,6 +124,57 @@ Or set the job_template to nil to have your jobs execute normally.
 set :job_template, nil
 ```
 
+### Parsing dates and times
+
+Whenever uses the [Chronic](https://github.com/mojombo/chronic) gem to parse the specified dates and times.
+
+You can set your custom Chronic configuration if the defaults don't fit you.
+
+For example, to assume a 24 hour clock instead of the default 12 hour clock:
+
+```ruby
+set :chronic_options, hours24: true
+
+# By default this would run the job every day at 3am
+every 1.day, at: '3:00' do
+  runner "MyModel.nightly_archive_job"
+end
+```
+
+You can see a list of all available options here: <https://github.com/mojombo/chronic/blob/master/lib/chronic/parser.rb>
+
+### Customize email recipient with the `MAILTO` environment variable
+
+Output from the jobs is sent to the email address configured in the `MAILTO` environment variable.
+
+There are many ways to further configure the recipient.
+
+Example: A global configuration, overriding the environment's value:
+
+```ruby
+env 'MAILTO', 'output_of_cron@example.com'
+
+every 3.hours do
+  command "/usr/bin/my_great_command"
+end
+```
+
+Example: A `MAILTO` configured for all the jobs in an interval block:
+
+```ruby
+every 3.hours, mailto: 'my_super_command@example.com'  do
+  command "/usr/bin/my_super_command"
+end
+```
+
+Example: A `MAILTO` configured for a single job:
+
+```ruby
+every 3.hours do
+  command "/usr/bin/my_super_command", mailto: 'my_super_command_output@example.com'
+end
+```
+
 ### Capistrano integration
 
 Use the built-in Capistrano recipe for easy crontab updates with deploys. For Capistrano V3, see the next section.
@@ -140,7 +202,7 @@ require "whenever/capistrano"
 
 The capistrano variable `:stage` should be the one holding your environment name. This will make the correct `:environment` available in your `schedule.rb`.
 
-If both your environments are on the same server you'll want to namespace them or they'll overwrite each other when you deploy:
+If both your environments are on the same server you'll want to namespace them, or they'll overwrite each other when you deploy:
 
 ```ruby
 set :whenever_environment, defer { stage }
@@ -148,6 +210,13 @@ set :whenever_identifier, defer { "#{application}_#{stage}" }
 require "whenever/capistrano"
 ```
 
+If you use a schedule at an alternative path, you may configure it like so:
+
+```ruby
+set :whenever_load_file, defer { "#{release_path}/somewhere/else/schedule.rb" }
+require "whenever/capistrano"
+```
+
 ### Capistrano V3 Integration
 
 In your "Capfile" file:
@@ -172,10 +241,10 @@ different servers in your capistrano deployment, then you can safely stop readin
 now and everything should just work the same way it always has.
 
 When you define a job in your schedule.rb file, by default it will be deployed to
-all servers in the whenever_roles list (which defaults to [:db]).
+all servers in the whenever_roles list (which defaults to `[:db]`).
 
 However, if you want to restrict certain jobs to only run on subset of servers,
-you can add a :roles => [...] argument to their definitions. **Make sure to add
+you can add a `roles: [...]` argument to their definitions. **Make sure to add
 that role to the whenever_roles list in your deploy.rb.**
 
 When you run `cap deploy`, jobs with a :roles list specified will only be added to
@@ -184,28 +253,28 @@ the crontabs on servers with one or more of the roles in that list.
 Jobs with no :roles argument will be deployed to all servers in the whenever_roles
 list. This is to maintain backward compatibility with previous releases of whenever.
 
-So, for example, with the default whenever_roles of [:db], a job like this would be
-deployed to all servers with the :db role:
+So, for example, with the default whenever_roles of `[:db]`, a job like this would be
+deployed to all servers with the `:db` role:
 
 ```ruby
-every :day, :at => '12:20am' do
+every :day, at: '12:20am' do
   rake 'foo:bar'
 end
 ```
 
-If we set whenever_roles to [:db, :app] in deploy.rb, and have the following
+If we set whenever_roles to `[:db, :app]` in deploy.rb, and have the following
 jobs in schedule.rb:
 
 ```ruby
-every :day, :at => '1:37pm', :roles => [:app] do
+every :day, at: '1:37pm', roles: [:app] do
   rake 'app:task' # will only be added to crontabs of :app servers
 end
 
-every :hour, :roles => [:db] do
+every :hour, roles: [:db] do
   rake 'db:task' # will only be added to crontabs of :db servers
 end
 
-every :day, :at => '12:02am' do
+every :day, at: '12:02am' do
   command "run_this_everywhere" # will be deployed to :db and :app servers
 end
 ```
@@ -253,8 +322,8 @@ It's a little bit dated now, but remains a good introduction.
 
 ----
 
-[![Build Status](https://secure.travis-ci.org/javan/whenever.png)](http://travis-ci.org/javan/whenever)
+[![Build Status](https://secure.travis-ci.org/javan/whenever.svg)](http://travis-ci.org/javan/whenever)
 
 ----
 
-Copyright &copy; 2016 Javan Makhmali
+Copyright &copy; 2017 Javan Makhmali

data/bin/whenever

@@ -35,6 +35,9 @@ OptionParser.new do |opts|
   opts.on('-r', '--roles [role1,role2]', 'Comma-separated list of server roles to generate cron jobs for') do |roles|
     options[:roles] = roles.split(',').map(&:to_sym) if roles
   end
+  opts.on('-x', '--crontab-command [command]', 'Default: crontab') do |crontab_command|
+    options[:crontab_command] = crontab_command if crontab_command
+  end
   opts.on('-v', '--version') { puts "Whenever v#{Whenever::VERSION}"; exit(0) }
 end.parse!
 

data/bin/wheneverize

@@ -58,9 +58,12 @@ if File.exist?(file)
   warn "[skip] `#{file}' already exists"
 elsif File.exist?(file.downcase)
   warn "[skip] `#{file.downcase}' exists, which could conflict with `#{file}'"
-elsif !File.exist?(File.dirname(file))
-  warn "[skip] directory `#{File.dirname(file)}' does not exist"
 else
+  dir = File.dirname(file)
+  if !File.exist?(dir)
+    warn "[add] creating `#{dir}'"
+    FileUtils.mkdir_p(dir)
+  end
   puts "[add] writing `#{file}'"
   File.open(file, "w") { |f| f.write(content) }
 end

data/gemfiles/activesupport4.1.gemfile

@@ -1,4 +1,6 @@
-source "https://rubygems.org"
+# This file was generated by Appraisal
+
+source "http://rubygems.org"
 
 gem "activesupport", "~> 4.1.0"
 

data/gemfiles/activesupport4.2.gemfile

@@ -1,4 +1,6 @@
-source "https://rubygems.org"
+# This file was generated by Appraisal
+
+source "http://rubygems.org"
 
 gem "activesupport", "~> 4.2.0"
 

data/gemfiles/activesupport5.0.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "http://rubygems.org"
+
+gem "activesupport", "~> 5.0.0"
+
+gemspec path: "../"

data/gemfiles/activesupport5.1.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "http://rubygems.org"
+
+gem "activesupport", "~> 5.1.0"
+
+gemspec path: "../"

data/gemfiles/activesupport5.2.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "http://rubygems.org"
+
+gem "activesupport", "~> 5.2.0beta2"
+
+gemspec path: "../"

data/lib/whenever/capistrano/v2/recipes.rb

@@ -11,6 +11,7 @@ Capistrano::Configuration.instance(:must_exist).load do
   _cset(:whenever_variables)    { "environment=#{fetch :whenever_environment}" }
   _cset(:whenever_update_flags) { "--update-crontab #{fetch :whenever_identifier} --set #{fetch :whenever_variables}" }
   _cset(:whenever_clear_flags)  { "--clear-crontab #{fetch :whenever_identifier}" }
+  _cset(:whenever_path)         { fetch :latest_release }
 
   namespace :whenever do
     desc "Update application's crontab entries using Whenever"
@@ -18,7 +19,7 @@ Capistrano::Configuration.instance(:must_exist).load do
       args = {
         :command => fetch(:whenever_command),
         :flags   => fetch(:whenever_update_flags),
-        :path    => fetch(:latest_release)
+        :path    => fetch(:whenever_path)
       }
 
       if whenever_servers.any?
@@ -38,7 +39,7 @@ Capistrano::Configuration.instance(:must_exist).load do
         args = {
           :command => fetch(:whenever_command),
           :flags   => fetch(:whenever_clear_flags),
-          :path    => fetch(:latest_release)
+          :path    => fetch(:whenever_path)
         }
 
         whenever_run_commands(args)

data/lib/whenever/capistrano/v3/tasks/whenever.rake

@@ -4,7 +4,7 @@ namespace :whenever do
 
     on roles fetch(:whenever_roles) do |host|
       args_for_host = block_given? ? args + Array(yield(host)) : args
-      within release_path do
+      within fetch(:whenever_path) do
         with fetch(:whenever_command_environment_variables) do
           execute(*args_for_host)
         end
@@ -12,17 +12,28 @@ namespace :whenever do
     end
   end
 
+  def load_file
+    file = fetch(:whenever_load_file)
+    if file
+      "-f #{file}"
+    else
+      ''
+    end
+  end
+
   desc "Update application's crontab entries using Whenever"
   task :update_crontab do
     setup_whenever_task do |host|
       roles = host.roles_array.join(",")
-      [fetch(:whenever_update_flags),  "--roles=#{roles}"]
+      [fetch(:whenever_update_flags), "--roles=#{roles}", load_file]
     end
   end
 
   desc "Clear application's crontab entries using Whenever"
   task :clear_crontab do
-    setup_whenever_task(fetch(:whenever_clear_flags))
+    setup_whenever_task do |host|
+      [fetch(:whenever_clear_flags), load_file]
+    end
   end
 
   after "deploy:updated",  "whenever:update_crontab"
@@ -33,11 +44,13 @@ namespace :load do
   task :defaults do
     set :whenever_roles,        ->{ :db }
     set :whenever_command,      ->{ [:bundle, :exec, :whenever] }
-    set :whenever_command_environment_variables, ->{ { rails_env: fetch(:whenever_environment) } }
+    set :whenever_command_environment_variables, ->{ fetch(:default_env).merge(rails_env: fetch(:whenever_environment)) }
     set :whenever_identifier,   ->{ fetch :application }
     set :whenever_environment,  ->{ fetch :rails_env, fetch(:stage, "production") }
     set :whenever_variables,    ->{ "environment=#{fetch :whenever_environment}" }
+    set :whenever_load_file,    ->{ nil }
     set :whenever_update_flags, ->{ "--update-crontab #{fetch :whenever_identifier} --set #{fetch :whenever_variables}" }
     set :whenever_clear_flags,  ->{ "--clear-crontab #{fetch :whenever_identifier}" }
+    set :whenever_path,         ->{ release_path }
   end
 end

data/lib/whenever/command_line.rb

@@ -9,9 +9,10 @@ module Whenever
     def initialize(options={})
       @options = options
 
-      @options[:file]       ||= 'config/schedule.rb'
-      @options[:cut]        ||= 0
-      @options[:identifier] ||= default_identifier
+      @options[:crontab_command] ||= 'crontab'
+      @options[:file]            ||= 'config/schedule.rb'
+      @options[:cut]             ||= 0
+      @options[:identifier]      ||= default_identifier
 
       if !File.exist?(@options[:file]) && @options[:clear].nil?
         warn("[fail] Can't find file: #{@options[:file]}")
@@ -28,6 +29,8 @@ module Whenever
         exit(1)
       end
       @options[:cut] = @options[:cut].to_i
+
+      @timestamp = Time.now.to_s
     end
 
     def run
@@ -55,9 +58,10 @@ module Whenever
     end
 
     def read_crontab
-      return @current_crontab if @current_crontab
+      return @current_crontab if instance_variable_defined?(:@current_crontab)
 
-      command = ['crontab -l']
+      command = [@options[:crontab_command]]
+      command << '-l'
       command << "-u #{@options[:user]}" if @options[:user]
 
       command_results  = %x[#{command.join(' ')} 2> /dev/null]
@@ -65,7 +69,7 @@ module Whenever
     end
 
     def write_crontab(contents)
-      command = ['crontab']
+      command = [@options[:crontab_command]]
       command << "-u #{@options[:user]}" if @options[:user]
       # Solaris/SmartOS cron does not support the - option to read from stdin.
       command << "-" unless OS.solaris?
@@ -90,19 +94,19 @@ module Whenever
 
     def updated_crontab
       # Check for unopened or unclosed identifier blocks
-      if read_crontab =~ Regexp.new("^#{comment_open}\s*$") && (read_crontab =~ Regexp.new("^#{comment_close}\s*$")).nil?
-        warn "[fail] Unclosed indentifier; Your crontab file contains '#{comment_open}', but no '#{comment_close}'"
+      if read_crontab =~ Regexp.new("^#{comment_open_regex}\s*$") && (read_crontab =~ Regexp.new("^#{comment_close_regex}\s*$")).nil?
+        warn "[fail] Unclosed indentifier; Your crontab file contains '#{comment_open(false)}', but no '#{comment_close(false)}'"
         exit(1)
-      elsif (read_crontab =~ Regexp.new("^#{comment_open}\s*$")).nil? && read_crontab =~ Regexp.new("^#{comment_close}\s*$")
-        warn "[fail] Unopened indentifier; Your crontab file contains '#{comment_close}', but no '#{comment_open}'"
+      elsif (read_crontab =~ Regexp.new("^#{comment_open_regex}\s*$")).nil? && read_crontab =~ Regexp.new("^#{comment_close_regex}\s*$")
+        warn "[fail] Unopened indentifier; Your crontab file contains '#{comment_close(false)}', but no '#{comment_open(false)}'"
         exit(1)
       end
 
-      # If an existing identier block is found, replace it with the new cron entries
-      if read_crontab =~ Regexp.new("^#{comment_open}\s*$") && read_crontab =~ Regexp.new("^#{comment_close}\s*$")
+      # If an existing identifier block is found, replace it with the new cron entries
+      if read_crontab =~ Regexp.new("^#{comment_open_regex}\s*$") && read_crontab =~ Regexp.new("^#{comment_close_regex}\s*$")
         # If the existing crontab file contains backslashes they get lost going through gsub.
         # .gsub('\\', '\\\\\\') preserves them. Go figure.
-        read_crontab.gsub(Regexp.new("^#{comment_open}\s*$.+^#{comment_close}\s*$", Regexp::MULTILINE), whenever_cron.chomp.gsub('\\', '\\\\\\'))
+        read_crontab.gsub(Regexp.new("^#{comment_open_regex}\s*$.+^#{comment_close_regex}\s*$", Regexp::MULTILINE), whenever_cron.chomp.gsub('\\', '\\\\\\'))
       else # Otherwise, append the new cron entries after any existing ones
         [read_crontab, whenever_cron].join("\n\n")
       end.gsub(/\n{3,}/, "\n\n") # More than two newlines becomes just two.
@@ -120,16 +124,32 @@ module Whenever
       stripped_contents.gsub!(/\s+$/, $/)
     end
 
-    def comment_base
-      "Whenever generated tasks for: #{@options[:identifier]}"
+    def comment_base(include_timestamp = true)
+      if include_timestamp
+        "Whenever generated tasks for: #{@options[:identifier]} at: #{@timestamp}"
+      else
+        "Whenever generated tasks for: #{@options[:identifier]}"
+      end
+    end
+
+    def comment_open(include_timestamp = true)
+      "# Begin #{comment_base(include_timestamp)}"
+    end
+
+    def comment_close(include_timestamp = true)
+      "# End #{comment_base(include_timestamp)}"
+    end
+
+    def comment_open_regex
+      "#{comment_open(false)}(#{timestamp_regex}|)"
     end
 
-    def comment_open
-      "# Begin #{comment_base}"
+    def comment_close_regex
+      "#{comment_close(false)}(#{timestamp_regex}|)"
     end
 
-    def comment_close
-      "# End #{comment_base}"
+    def timestamp_regex
+      " at: \\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2} ([+-]\\d{4}|UTC)"
     end
   end
 end