say_when 0.1.0

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.DS_Store

data/Gemfile

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

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/generators/say_when_migration/say_when_migration_generator.rb

@@ -0,0 +1,11 @@
+class SayWhenMigrationGenerator < Rails::Generator::Base 
+  def manifest 
+    record do |m| 
+      m.migration_template 'migration.rb', 'db/migrate' 
+    end 
+  end
+  
+  def file_name
+    "say_when_migration"
+  end
+end

data/generators/say_when_migration/templates/migration.rb

@@ -0,0 +1,48 @@
+class SayWhenMigration < ActiveRecord::Migration
+  def self.up
+
+    create_table :say_when_jobs, :force => true do |t|
+
+      t.string    :group
+      t.string    :name
+
+      t.string    :status
+
+      t.string    :trigger_strategy
+      t.text      :trigger_options
+
+      t.timestamp :last_fire_at
+      t.timestamp :next_fire_at
+
+      t.timestamp :start_at
+      t.timestamp :end_at
+
+      t.string    :job_class
+      t.string    :job_method
+      t.text      :data
+
+      t.string    :scheduled_type
+      t.integer   :scheduled_id
+
+      t.timestamps
+    end
+
+    create_table :say_when_job_executions, :force => true do |t|
+      t.integer  :job_id
+      t.string   :status
+      t.text     :result
+      t.datetime :start_at
+      t.datetime :end_at
+    end
+    
+    add_index :say_when_jobs, :status
+    add_index :say_when_jobs, :next_fire_at
+    add_index :say_when_job_executions, :job_id
+  end
+
+  
+  def self.down
+    drop_table :say_when_job_executions
+    drop_table :say_when_jobs
+  end
+end

data/lib/generators/say_when/migration/migration_generator.rb

@@ -0,0 +1,13 @@
+module SayWhen
+  class MigrationGenerator < Rails::Generator::Base
+    def manifest 
+      record do |m| 
+        m.migration_template 'migration.rb', 'db/migrate' 
+      end 
+    end
+    
+    def file_name
+      "say_when_migration"
+    end
+  end
+end

data/lib/generators/say_when/migration/templates/migration.rb

@@ -0,0 +1,47 @@
+class SayWhenMigration < ActiveRecord::Migration
+  def self.up
+
+    create_table :say_when_jobs, :force => true do |t|
+
+      t.string    :group
+      t.string    :name
+
+      t.string    :status
+
+      t.string    :trigger_strategy
+      t.text      :trigger_options
+
+      t.timestamp :last_fire_at
+      t.timestamp :next_fire_at
+
+      t.timestamp :start_at
+      t.timestamp :end_at
+
+      t.string    :job_class
+      t.string    :job_method
+      t.text      :data
+
+      t.string    :scheduled_type
+      t.integer   :scheduled_id
+
+      t.timestamps
+    end
+
+    create_table :say_when_job_executions, :force => true do |t|
+      t.integer  :job_id
+      t.string   :status
+      t.text     :result
+      t.datetime :start_at
+      t.datetime :end_at
+    end
+    
+    add_index :say_when_jobs, :status
+    add_index :say_when_jobs, :next_fire_at
+  end
+  
+  def self.down
+    drop_table :say_when_job_executions
+    drop_table :say_when_jobs
+  end
+
+end

data/lib/say_when/base_job.rb

@@ -0,0 +1,96 @@
+module SayWhen
+  module BaseJob
+
+    # ready to be run, just waiting for its turn
+    STATE_WAITING = 'waiting'
+
+    # has been acquired b/c it is time to be triggered
+    STATE_ACQUIRED = 'acquired'
+
+    # # related job for the trigger is executing
+    # STATE_EXECUTING = 'executing'
+
+    # "Complete" means the trigger has no remaining fire times
+    STATE_COMPLETE = 'complete'
+
+    # A Trigger arrives at the error state when the scheduler
+    # attempts to fire it, but cannot due to an error creating and executing
+    # its related job.
+    STATE_ERROR = 'error'
+
+    def lock
+      @_lock ||= Mutex.new
+    end
+
+    def trigger
+      @trigger ||= load_trigger
+    end
+
+    def fired
+      self.lock.synchronize {
+        fired = Time.now
+        next_fire = trigger.next_fire_at(fired) rescue nil
+        self.last_fire_at = fired
+        self.next_fire_at = next_fire
+
+        if next_fire.nil?
+          self.status = STATE_COMPLETE
+        else
+          self.status = STATE_WAITING
+        end
+      }
+    end
+
+    def release
+      self.lock.synchronize {
+        if self.status == STATE_ACQUIRED
+          self.status = STATE_WAITING
+        end
+      }
+    end
+
+    def execute
+      self.execute_job(data)
+    end
+
+    def load_trigger
+      strategy = trigger_strategy || :once
+      require "say_when/triggers/#{strategy}_strategy"
+      trigger_class_name = "SayWhen::Triggers::#{strategy.to_s.camelize}Strategy"
+      trigger_class = trigger_class_name.constantize
+      trigger_class.new(trigger_options)
+    end
+
+    def execute_job(options)
+      task_method = (self.job_method || 'execute').to_s
+      task = get_task(task_method)
+      task.send(task_method, options)
+    end
+
+    def get_task(task_method)
+      task = nil
+
+      if self.job_class
+        tc = self.job_class.constantize
+        if tc.respond_to?(task_method)
+          task = tc
+        else
+          to = tc.new
+          if to.respond_to?(task_method)
+            task = to
+          else
+            raise "Neither '#{self.job_class}' class nor instance respond to '#{task_method}'"
+          end
+        end
+      elsif self.scheduled
+        if self.scheduled.respond_to?(task_method)
+          task = self.scheduled
+        else
+          raise "Scheduled '#{self.scheduled.inspect}' does not respond to '#{task_method}'"
+        end
+      end
+      task
+    end
+
+  end
+end