round_robin 1.1.0 → 1.2.0

data/README.md

@@ -30,11 +30,29 @@ Now fire up two workers with:
 
     COUNT=2 rake round_robin:workers
 
-The two workers workers will take one job at a time each and process them in order.
+The two workers workers will take one job at a time each and process them in
+order.
 
 The workers will be persisted and will be kept even after a restart of the
 server. Typically in a Rails project a `RoundRobin.add` can be called in an
 `after_create` callback and similarly a `RoundRobin.remove` may be called
 `after_destroy`.
 
+The RoundRobin.add call returns a RoundRobin::Job, that descends from
+ActiveRecord::Base. That record has the following attributes of interest,
+
+    started_at, finished_at: datetime
+
+When the job was started and finished most recently.
+
+    every_n_hours: integer
+
+Whether to skip to job unless it was atleast n hours since it was run last
+time.  Use this to avoid running a job more often than preferred. By default
+set to nil. Nil and zero means as often as possible.
+
+    skip: boolean
+
+Whether the job should be skipped in the future. By default set to false.
+
 Round Robin is inspired by Resque and DelayedJob.

data/lib/round_robin/job.rb

@@ -5,8 +5,10 @@ module RoundRobin
     self.table_name = 'round_robin_jobs'
 
     def invoke_job
+      update_attribute :invoked_at, Time.now
+      return unless runnable?
       begin
-        update_attributes(:started_at =>  Time.now, :finished_at => nil)
+        update_attributes(:started_at => Time.now, :finished_at => nil)
         klass = Module.const_get(parsed_handler["class"])
         args = parsed_handler["args"]
         klass.perform(*args)
@@ -17,8 +19,12 @@ module RoundRobin
       end
     end
 
+    def runnable?
+      !skip && (every_n_hours.nil? || every_n_hours == 0 || invoked_at.nil? || invoked_at < every_n_hours.hours.ago)
+    end
 
     private
+
     def parsed_handler
       @parsed_handler ||= JSON.parse(handler)
     end

data/lib/round_robin/worker.rb

@@ -4,7 +4,7 @@ module RoundRobin
 
     def work
       begin
-        RoundRobin::Job.order("started_at").limit(1).first.try(:invoke_job)
+        RoundRobin::Job.order("invoked_at").limit(1).first.try(:invoke_job)
         sleep sleep_time
       end while not shutdown
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: round_robin
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-14 00:00:00.000000000Z
+date: 2012-05-09 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70301459842800 !ruby/object:Gem::Requirement
+  requirement: &70162860081960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,7 +22,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70301459842800
+  version_requirements: *70162860081960
 description: ''
 email:
 - jan.andersson@gmail.com