yakischloba-em-timers 0.0.1

data/README

@@ -0,0 +1,39 @@
+em-timers
+
+helper methods for timers in EventMachine
+
+examples:
+
+# Once per hour, starting now. Note the :now symbol must be passed for your block to be called immediately.
+EM.do_hourly(:starting => :now) { puts "drink a beer" }
+
+# Once per day, starting in 1 day.
+EM.do_daily { puts "take a shower" }
+
+# Once per week, starting in 10 hours
+EM.do_weekly(:starting => 10.hours.from_now) { puts "take out the garbage" }
+
+# Once per month, starting at this time tomorrow.
+EM.do_monthly(:starting => 1.day.from_now) { puts "pay the bills" }
+
+# Or you can simply pass a number of seconds til starting
+EM.do_monthly(:starting => 2592000) { puts "pay the bills, in seconds!" }
+
+# Leveraging the Chronic time parsing library. em-timers knows if you have required 
+# Chronic and uses it to parse strings if you have. Otherwise, it uses Time.parse.
+#
+# Every 2 hours, starting next Tuesday at 9AM.
+require 'chronic'
+EM.do(:every => 2.hours, :starting => 'next tuesday at 9am') { puts "go pee" }
+
+# You can add up units of time as well
+EM.do(:every => 1.minutes + 3.seconds) { puts "hi!" }
+
+
+TODO:
+
+Maintain a list of task signatures and their associated timer signatures so tasks can be canceled.
+
+
+jakecdouglas@gmail.com
+yakischloba on Freenode #eventmachine

data/lib/em-timers.rb

@@ -0,0 +1,7 @@
+$:.unshift File.expand_path(File.dirname(File.expand_path(__FILE__)))
+require 'eventmachine'
+require 'time'
+require 'em-timers/em-timers'
+require 'em-timers/numericmixable'
+
+Numeric.send :include, NumericMixable

data/lib/em-timers/em-timers.rb

@@ -0,0 +1,54 @@
+module EventMachine
+
+  def self.do(options={}, &blk)
+    increment = options[:every]
+    starting = options[:starting]
+
+    reschedule = proc {|inc, block| EM.add_timer(inc) { reschedule.call(inc, block) } ; block.call }
+
+    if starting == :now
+      EM.add_timer(increment) { reschedule.call(increment, blk) }
+      blk.call
+      return nil
+    else
+      if starting.is_a?(String)
+        starting = Object.const_defined?("Chronic") ? Chronic.parse(starting) : Time.parse(starting)
+      elsif starting.is_a?(Time) || starting.kind_of?(Numeric)
+        starting = starting
+      else
+        starting = Time.now
+      end
+    end
+
+    if starting.is_a?(Time)
+      time = starting - Time.now
+    else
+      time = starting
+    end
+
+    while time < 0
+      time += increment
+    end
+
+    EM.add_timer(time) { reschedule.call(increment, blk) }
+
+    return nil
+  end
+
+  def self.do_hourly(options={}, &blk)
+    self.do({:every => 1.hour}.merge(options), &blk)
+  end
+
+  def self.do_daily(options={}, &blk)
+    self.do({:every => 1.day}.merge(options), &blk)
+  end
+
+  def self.do_weekly(options={}, &blk)
+    self.do({:every => 1.week}.merge(options), &blk)
+  end
+
+  def self.do_monthly(options={}, &blk)
+    self.do({:every => 1.month}.merge(options), &blk)
+  end
+
+end

data/lib/em-timers/numericmixable.rb

@@ -0,0 +1,56 @@
+# Stolen directly from ramaze/snippets
+module NumericMixable
+  def seconds
+    self
+  end
+  alias second seconds
+
+  # 60 seconds in a minute
+  def minutes
+    self * 60
+  end
+  alias minute minutes
+
+  # 60 minutes in an hour
+  def hours
+    self * 3600
+  end
+  alias hour hours
+
+  # 24 hours in a day
+  def days
+    self * 86400
+  end
+  alias day days
+
+  # 7 days in a week
+  def weeks
+    self * 604800
+  end
+  alias week weeks
+
+  # 30 days in a month
+  def months
+    self * 2592000
+  end
+  alias month months
+
+  # 365.25 days in a year
+  def years
+    self * 883612800
+  end
+  alias year years
+
+  # Time in the past, i.e. 3.days.ago
+  def ago t = Time.now
+    t - self
+  end
+  alias before ago
+
+  # Time in the future, i.e. 3.days.from_now
+  def from_now t = Time.now
+    t + self
+  end
+  alias since from_now
+
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: yakischloba-em-timers
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jake Douglas
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-27 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: helper methods for timers in EventMachine
+email: jakecdouglas@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README
+- lib/em-timers.rb
+- lib/em-timers/numericmixable.rb
+- lib/em-timers/em-timers.rb
+has_rdoc: false
+homepage: http://www.github.com/yakischloba/em-timers
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: helper methods for timers in EventMachine
+test_files: []
+