class Whenever::JobList

Attributes

roles[R]

Public Class Methods

new(options) click to toggle source
# File lib/whenever/job_list.rb, line 5
def initialize(options)
  @jobs, @env, @set_variables, @pre_set_variables = {}, {}, {}, {}

  if options.is_a? String
    options = { :string => options }
  end

  pre_set(options[:set])

  @roles = options[:roles] || []

  setup_file = File.expand_path('../setup.rb', __FILE__)
  setup = File.read(setup_file)
  schedule = if options[:string]
    options[:string]
  elsif options[:file]
    File.read(options[:file])
  end

  instance_eval(setup, setup_file)
  instance_eval(schedule, options[:file] || '<eval>')
end

Public Instance Methods

env(variable, value) click to toggle source
# File lib/whenever/job_list.rb, line 37
def env(variable, value)
  @env[variable.to_s] = value
end
every(frequency, options = {}) { || ... } click to toggle source
# File lib/whenever/job_list.rb, line 41
def every(frequency, options = {})
  @current_time_scope = frequency
  @options = options
  yield
end
generate_cron_output() click to toggle source
# File lib/whenever/job_list.rb, line 64
def generate_cron_output
  [environment_variables, cron_jobs].compact.join
end
job_type(name, template) click to toggle source
# File lib/whenever/job_list.rb, line 47
def job_type(name, template)
  class_eval do
    define_method(name) do |task, *args|
      options = { :task => task, :template => template }
      options.merge!(args[0]) if args[0].is_a? Hash

      # :cron_log was an old option for output redirection, it remains for backwards compatibility
      options[:output] = (options[:cron_log] || @cron_log) if defined?(@cron_log) || options.has_key?(:cron_log)
      # :output is the newer, more flexible option.
      options[:output] = @output if defined?(@output) && !options.has_key?(:output)

      @jobs[@current_time_scope] ||= []
      @jobs[@current_time_scope] << Whenever::Job.new(@options.merge(@set_variables).merge(options))
    end
  end
end
set(variable, value) click to toggle source
# File lib/whenever/job_list.rb, line 28
def set(variable, value)
  variable = variable.to_sym
  return if @pre_set_variables[variable]

  instance_variable_set("@#{variable}".to_sym, value)
  self.class.send(:attr_reader, variable.to_sym)
  @set_variables[variable] = value
end

Private Instance Methods

combine(entries) click to toggle source

Takes the standard cron output that Whenever generates and finds similar entries that can be combined. For example: If a job should run at 3:02am and 4:02am, instead of creating two jobs this method combines them into one that runs on the 2nd minute at the 3rd and 4th hour.

# File lib/whenever/job_list.rb, line 108
def combine(entries)
  entries.map! { |entry| entry.split(/ +/, 6) }
  0.upto(4) do |f|
    (entries.length-1).downto(1) do |i|
      next if entries[i][f] == '*'
      comparison = entries[i][0...f] + entries[i][f+1..-1]
      (i-1).downto(0) do |j|
        next if entries[j][f] == '*'
        if comparison == entries[j][0...f] + entries[j][f+1..-1]
          entries[j][f] += ',' + entries[i][f]
          entries.delete_at(i)
          break
        end
      end
    end
  end

  entries.map { |entry| entry.join(' ') }
end
cron_jobs() click to toggle source
# File lib/whenever/job_list.rb, line 128
def cron_jobs
  return if @jobs.empty?

  shortcut_jobs = []
  regular_jobs = []

  output_all = roles.empty?
  @jobs.each do |time, jobs|
    jobs.each do |job|
      next unless output_all || roles.any? do |r|
        job.has_role?(r)
      end
      Whenever::Output::Cron.output(time, job) do |cron|
        cron << "\n\n"

        if cron.starts_with?("@")
          shortcut_jobs << cron
        else
          regular_jobs << cron
        end
      end
    end
  end

  shortcut_jobs.join + combine(regular_jobs).join
end
environment_variables() click to toggle source
# File lib/whenever/job_list.rb, line 90
def environment_variables
  return if @env.empty?

  output = []
  @env.each do |key, val|
    output << "#{key}=#{val.blank? ? '""' : val}\n"
  end
  output << "\n"

  output.join
end
pre_set(variable_string = nil) click to toggle source

Takes a string like: “variable1=something&variable2=somethingelse” and breaks it into variable/value pairs. Used for setting variables at runtime from the command line. Only works for setting values as strings.

# File lib/whenever/job_list.rb, line 75
def pre_set(variable_string = nil)
  return if variable_string.blank?

  pairs = variable_string.split('&')
  pairs.each do |pair|
    next unless pair.index('=')
    variable, value = *pair.split('=')
    unless variable.blank? || value.blank?
      variable = variable.strip.to_sym
      set(variable, value.strip)
      @pre_set_variables[variable] = value
    end
  end
end