qe 0.2.0 → 0.2.1

data/Gemfile.lock

@@ -1,53 +1,53 @@
 PATH
   remote: .
   specs:
-    qe (0.2.0)
+    qe (0.2.1)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.2.9)
-      activesupport (= 3.2.9)
+    activemodel (3.2.11)
+      activesupport (= 3.2.11)
       builder (~> 3.0.0)
-    activerecord (3.2.9)
-      activemodel (= 3.2.9)
-      activesupport (= 3.2.9)
+    activerecord (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
       arel (~> 3.0.2)
       tzinfo (~> 0.3.29)
-    activesupport (3.2.9)
+    activesupport (3.2.11)
       i18n (~> 0.6)
       multi_json (~> 1.0)
     arel (3.0.2)
     awesome_print (1.1.0)
-    backburner (0.3.0)
-      beaneater (~> 0.2.0)
+    backburner (0.3.2)
+      beaneater (~> 0.3.0)
       dante (~> 0.1.5)
-    beaneater (0.2.0)
+    beaneater (0.3.0)
     builder (3.0.4)
-    celluloid (0.12.3)
+    celluloid (0.12.4)
       facter (>= 1.6.12)
       timers (>= 1.0.0)
     coderay (1.0.8)
-    connection_pool (0.9.2)
+    connection_pool (1.0.0)
     dante (0.1.5)
-    delayed_job (3.0.4)
+    delayed_job (3.0.5)
       activesupport (~> 3.0)
     delayed_job_active_record (0.3.3)
       activerecord (>= 2.1.0, < 4)
       delayed_job (~> 3.0)
     diff-lcs (1.1.3)
-    facter (1.6.14)
+    facter (1.6.17)
     i18n (0.6.1)
     method_source (0.8.1)
-    multi_json (1.3.7)
-    pry (0.9.10)
+    multi_json (1.5.0)
+    pry (0.9.11.4)
       coderay (~> 1.0.5)
       method_source (~> 0.8)
-      slop (~> 3.3.1)
+      slop (~> 3.4)
     qu (0.2.0)
       multi_json
-    rack (1.4.1)
-    rack-protection (1.2.0)
+    rack (1.5.1)
+    rack-protection (1.3.2)
       rack
     redis (3.0.2)
     redis-namespace (1.2.1)
@@ -57,28 +57,34 @@ GEM
       redis-namespace (~> 1.0)
       sinatra (>= 0.9.2)
       vegas (~> 0.1.2)
+    resque-scheduler (2.0.0)
+      redis (>= 2.0.1)
+      resque (>= 1.20.0)
+      rufus-scheduler
     rspec (2.12.0)
       rspec-core (~> 2.12.0)
       rspec-expectations (~> 2.12.0)
       rspec-mocks (~> 2.12.0)
-    rspec-core (2.12.0)
-    rspec-expectations (2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
       diff-lcs (~> 1.1.3)
-    rspec-mocks (2.12.0)
-    sidekiq (2.5.3)
+    rspec-mocks (2.12.2)
+    rufus-scheduler (2.0.17)
+      tzinfo (>= 0.3.23)
+    sidekiq (2.6.5)
       celluloid (~> 0.12.0)
-      connection_pool (~> 0.9.2)
+      connection_pool (~> 1.0)
       multi_json (~> 1)
       redis (~> 3)
       redis-namespace
-    sinatra (1.3.3)
-      rack (~> 1.3, >= 1.3.6)
-      rack-protection (~> 1.2)
+    sinatra (1.3.4)
+      rack (~> 1.4)
+      rack-protection (~> 1.3)
       tilt (~> 1.3, >= 1.3.3)
-    slop (3.3.3)
-    sqlite3 (1.3.6)
+    slop (3.4.3)
+    sqlite3 (1.3.7)
     tilt (1.3.3)
-    timers (1.0.1)
+    timers (1.1.0)
     tzinfo (0.3.35)
     vegas (0.1.11)
       rack (>= 1.0.0)
@@ -95,6 +101,7 @@ DEPENDENCIES
   qe!
   qu
   resque
+  resque-scheduler
   rspec
   sidekiq
   sqlite3

data/README.md

@@ -75,6 +75,17 @@ MailerWorker.enqueue({
 })
 ```
 
+You can specify when this job must be processed by setting the <tt>:run_at</tt> option.
+
+``` ruby
+MailerWorker.enqueue({
+  :mail => :follow_up,
+  :email => "john@example.org",
+  :name => "John Doe",
+  :run_at => 5.days.from_now
+})
+```
+
 ### Defining actions
 
 Sometimes you want to create several actions in a single worker, just because is easier. Instead of manually dispatch the action on your perform method, you can
@@ -109,6 +120,23 @@ NotificationWorker.enqueue(:message => "wat?")
 
 The action must be a existing public method. If not defined, `Qe::Action::MissingActionError` exception is raised.
 
+### Working with I18n
+
+When you're working in internationalized app, you need to perform some jobs with the correct locale set (sending an e-mail, maybe?). Instead of doing it manually, you can just use the `Qe::Locale` extension.
+
+This extension will set the `:locale` option when you enqueue some job and set it to `I18n.locale` when you perform it. Just include it after the `Qe::Worker` module.
+
+``` ruby
+class MailerWorker
+  include Qe::Worker
+  include Qe::Locale
+
+  def perform
+    Mailer.public_send(options[:mail], options).deliver
+  end
+end
+```
+
 ### Development support
 
 Qe comes with development support. Instead of starting up workers on development environment, you can use the `Qe::Immediate` adapter, which executes your worker right away!
@@ -130,7 +158,7 @@ require "qe/testing"
 Qe.adapter = Qe::Testing
 ```
 
-If you"re using RSpec, you can require the `qe/testing/rspec.rb` file
+If you are using RSpec, you can require the `qe/testing/rspec.rb` file
 instead. This will reset `Qe.jobs` before every spec and will add a
 `enqueue` matcher.
 

data/examples/.env

@@ -1,3 +1,4 @@
-QUEUES="mail,default"
-QUEUE="mail,default"
+QUEUE="later,mail,default"
+QUEUES="later,mail,default"
 BEANSTALK_URL="beanstalk://localhost/"
+GROUP=delayed_job

data/examples/Gemfile

@@ -1,14 +1,35 @@
 source :rubygems
 
-gem "sidekiq"
-gem "backburner"
-gem "beanstalkd_view"
 gem "rake"
 gem "thin"
-gem "resque"
-gem "activerecord"
-gem "delayed_job_active_record"
-gem "sqlite3"
 gem "daemons"
-gem "qu-redis"
-gem "slim"
+gem "pry"
+gem "pry-remote"
+gem "awesome_print"
+
+group :sidekiq do
+  gem "activesupport", :require => "active_support/all"
+  gem "sidekiq"
+  gem "slim"
+end
+
+group :resque do
+  gem "resque"
+  gem "resque-scheduler"
+end
+
+group :beanstalk do
+  gem "backburner"
+  gem "beanstalkd_view"
+end
+
+group :delayed_job do
+  gem "activerecord"
+  gem "delayed_job_active_record"
+  gem "delayed_job_web"
+  gem "sqlite3"
+end
+
+group :qu do
+  gem "qu-redis"
+end

data/examples/Gemfile.lock

@@ -1,25 +1,27 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.2.8)
-      activesupport (= 3.2.8)
+    activemodel (3.2.9)
+      activesupport (= 3.2.9)
       builder (~> 3.0.0)
-    activerecord (3.2.8)
-      activemodel (= 3.2.8)
-      activesupport (= 3.2.8)
+    activerecord (3.2.9)
+      activemodel (= 3.2.9)
+      activesupport (= 3.2.9)
       arel (~> 3.0.2)
       tzinfo (~> 0.3.29)
-    activesupport (3.2.8)
+    activesupport (3.2.9)
       i18n (~> 0.6)
       multi_json (~> 1.0)
     arel (3.0.2)
-    backburner (0.2.0)
-      beaneater (~> 0.1.2)
+    awesome_print (1.1.0)
+    backburner (0.3.0)
+      beaneater (~> 0.2.0)
       dante (~> 0.1.5)
     backports (2.6.5)
-    beaneater (0.1.2)
-    beanstalkd_view (1.1.0)
-      beaneater (~> 0.1.0)
+    beaneater (0.2.2)
+    beanstalk-client (1.1.1)
+    beanstalkd_view (1.0.2)
+      beanstalk-client (>= 1.1.1)
       json
       sinatra (>= 1.3.0)
       sinatra-assetpack (>= 0.0.11)
@@ -29,20 +31,36 @@ GEM
     celluloid (0.12.3)
       facter (>= 1.6.12)
       timers (>= 1.0.0)
+    coderay (1.0.8)
     connection_pool (0.9.2)
     daemons (1.1.9)
     dante (0.1.5)
-    delayed_job (3.0.3)
+    delayed_job (3.0.4)
       activesupport (~> 3.0)
     delayed_job_active_record (0.3.3)
       activerecord (>= 2.1.0, < 4)
       delayed_job (~> 3.0)
+    delayed_job_web (1.1.2)
+      activerecord (> 3.0.0)
+      delayed_job (> 2.0.3)
+      haml (~> 3.1.3)
+      rdoc
+      sinatra (>= 0.9.2)
     eventmachine (1.0.0)
-    facter (1.6.14)
+    facter (1.6.16)
+    haml (3.1.7)
     i18n (0.6.1)
     jsmin (1.0.1)
     json (1.7.5)
-    multi_json (1.3.7)
+    method_source (0.8.1)
+    multi_json (1.4.0)
+    pry (0.9.10)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.3.1)
+    pry-remote (0.1.6)
+      pry (~> 0.9)
+      slop (~> 3.0)
     qu (0.2.0)
       multi_json
     qu-redis (0.2.0)
@@ -54,7 +72,9 @@ GEM
       rack
     rack-test (0.6.2)
       rack (>= 1.0)
-    rake (0.9.2.2)
+    rake (10.0.2)
+    rdoc (3.12)
+      json (~> 1.4)
     redis (3.0.2)
     redis-namespace (1.2.1)
       redis (~> 3.0.0)
@@ -63,13 +83,19 @@ GEM
       redis-namespace (~> 1.0)
       sinatra (>= 0.9.2)
       vegas (~> 0.1.2)
-    sidekiq (2.5.2)
+    resque-scheduler (2.0.0)
+      redis (>= 2.0.1)
+      resque (>= 1.20.0)
+      rufus-scheduler
+    rufus-scheduler (2.0.17)
+      tzinfo (>= 0.3.23)
+    sidekiq (2.5.4)
       celluloid (~> 0.12.0)
       connection_pool (~> 0.9.2)
       multi_json (~> 1)
       redis (~> 3)
       redis-namespace
-    simple_uuid (0.2.0)
+    simple_uuid (0.3.0)
     sinatra (1.3.3)
       rack (~> 1.3, >= 1.3.6)
       rack-protection (~> 1.2)
@@ -86,9 +112,10 @@ GEM
       rack-test
       sinatra (~> 1.3.0)
       tilt (~> 1.3)
-    slim (1.3.3)
+    slim (1.3.4)
       temple (~> 0.5.5)
       tilt (~> 1.3.3)
+    slop (3.3.3)
     sqlite3 (1.3.6)
     temple (0.5.5)
     thin (1.5.0)
@@ -106,13 +133,19 @@ PLATFORMS
 
 DEPENDENCIES
   activerecord
+  activesupport
+  awesome_print
   backburner
   beanstalkd_view
   daemons
   delayed_job_active_record
+  delayed_job_web
+  pry
+  pry-remote
   qu-redis
   rake
   resque
+  resque-scheduler
   sidekiq
   slim
   sqlite3

data/examples/Procfile

@@ -1,20 +1,25 @@
-redis: redis-server redis.conf
+# redis: redis-server redis.conf
 # beanstalkd: beanstalkd
 
 # Uncomment the following lines to enable Sidekiq
-sidekiq: bundle exec sidekiq -r ./workers.rb -q default -q mail
-sidekiq_web: bundle exec thin -R sidekiq.ru -p 9292 -V start
+# sidekiq: bundle exec sidekiq -r ./workers.rb -q default -q mail -q later
+# sidekiq_web: bundle exec thin -R sidekiq.ru -p 9292 -V start
 
 # Uncomment the following lines to enable Beanstalk/Backburner
 # backburner: bundle exec rake backburner:work
 # beanstalkd_view: bundle exec thin -R beanstalkd.ru -p 9292 -V start
 
 # Uncomment the following line to enable DelayedJob
-# delayed_job: bundle exec rake jobs:work
+delayed_job: bundle exec rake delayed_job
+delayed_job_web: bundle exec thin -R delayed_job.ru -p 9292 -V start
 
 # Uncomment the following line to enable Qu
 # qu: bundle exec rake qu:work
 
 # Uncomment the following lines to enable Resque
 # resque: bundle exec rake resque:work
+# resque_scheduler: bundle exec rake resque:scheduler
 # resque_web: bundle exec thin -R resque.ru -p 9292 -V start
+
+# Add jobs every 3 seconds
+add_jobs: ruby add_jobs.rb

data/examples/README.md

@@ -1,9 +1,7 @@
 # Running examples
 
-1. First, start processes with `$ foreman start`
-2. Then execute `$ ruby sample.rb`
+1. Change the bundler group name on the `.env` file.
+2. Start processes with `$ foreman start`
 3. Go back to the Foreman's terminal and watch the output
 
-Tweak the `Procfile` to enable different libraries and web panels.
-
-You'll need to install Redis and/or Beanstalkd.
+Tweak the `Procfile` and `.env` files to enable different libraries and web panels.

data/examples/Rakefile

@@ -1,14 +1,15 @@
-require "backburner/tasks"
-require "resque/tasks"
-require "delayed/tasks"
-require "qu/tasks"
+require "./workers"
 
 task :environment do #=> required by Backburner
-  require "./workers"
 
-  Backburner.configure do |config|
-    config.logger = Logger.new(STDOUT)
-  end
 end
 
 task "resque:setup" => :environment
+
+desc "Setup delayed job consumer"
+task :delayed_job do
+  ENV["QUEUES"] = "later,mail,default"
+  ENV.delete("QUEUE")
+  Rake::Task["jobs:work"].reenable
+  Rake::Task["jobs:work"].invoke
+end

data/examples/{sample.rb → add_jobs.rb}

@@ -1,10 +1,9 @@
 require "./workers"
 
 loop do
-  puts "=> Enqueuing jobs [#{Time.now}]"
-
   MailerWorker.enqueue(:name => "John Doe", :email => "john@example.org")
   ClockWorker.enqueue
+  LaterWorker.enqueue :run_at => Time.now + 5, :time => Time.now
 
   sleep 3
 end

data/examples/beanstalkd.ru

@@ -1,5 +1,5 @@
 require "bundler"
-Bundler.setup(:default)
-Bundler.require(:default)
+Bundler.setup(:default, :beanstalk)
+Bundler.require(:default, :beanstalk)
 
 run BeanstalkdView::Server

data/examples/delayed_job.ru

@@ -0,0 +1,10 @@
+require "bundler"
+Bundler.setup(:default, :delayed_job)
+Bundler.require(:default, :delayed_job)
+
+ActiveRecord::Base.establish_connection(
+  :adapter => "sqlite3", :database => "jobs.sqlite3"
+)
+
+require "delayed_job_web"
+run DelayedJobWeb

data/examples/resque.ru

@@ -1,6 +1,6 @@
 require "bundler"
-Bundler.setup(:default)
-Bundler.require(:default)
+Bundler.setup(:default, :resque)
+Bundler.require(:default, :resque)
 
 require "resque/server"
 run Resque::Server

data/examples/sidekiq.ru

@@ -1,6 +1,6 @@
 require "bundler"
-Bundler.setup(:default)
-Bundler.require(:default)
+Bundler.setup(:default, :sidekiq)
+Bundler.require(:default, :sidekiq)
 
 Sidekiq.configure_client do |config|
   config.redis = { :size => 1 }

data/examples/workers.rb

@@ -1,26 +1,53 @@
 require "bundler"
-Bundler.setup(:default)
+Bundler.setup(:default, ENV.fetch("GROUP"))
 Bundler.require
 
+require "time"
+
 $:.unshift File.expand_path("../../lib", __FILE__)
-require "qe"
 
-$stdout.sync = true
+case ENV.fetch("GROUP")
+when "sidekiq"
+  require "qe/sidekiq"
+when "beanstalk"
+  require "qe/beanstalk"
+  require "backburner/tasks"
 
-Qe.adapter = Qe::Sidekiq
-# Qe.adapter = Qe::Beanstalk
-# Qe.adapter = Qe::Resque
-# Qe.adapter = Qe::DelayedJob
-# Qe.adapter = Qe::Qu
-# Qe.adapter = Qe::Testing
+  Backburner.configure do |config|
+    config.logger = Logger.new($stdout)
+  end
+when "resque"
+  require "qe/resque"
+  require "resque/tasks"
+  require "resque_scheduler/tasks"
+when "delayed_job"
+  require "delayed_job"
+  require "delayed_job_active_record"
+  require "qe/delayed_job"
+  require "active_record"
+  require "delayed/tasks"
+when "qu"
+  require "qe/qu"
+  require "qu/tasks"
+end
 
-ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :database => "jobs.sqlite3")
+$stdout.sync = true
+
+if defined?(Qe::DelayedJob)
+  ActiveRecord::Base.establish_connection(
+    :adapter => "sqlite3", :database => "jobs.sqlite3"
+  )
+end
 
 class ClockWorker
   include Qe::Worker
 
   def perform
+    puts
+    puts "---"
     puts "=> Time: #{Time.now}"
+    puts "---"
+    puts
   end
 end
 
@@ -29,6 +56,8 @@ class MailerWorker
   queue :mail
 
   def before
+    puts
+    puts "---"
     puts "=> Running before"
   end
 
@@ -39,5 +68,20 @@ class MailerWorker
 
   def after
     puts "=> Running after"
+    puts "---"
+    puts
+  end
+end
+
+class LaterWorker
+  include Qe::Worker
+
+  def perform
+    puts
+    puts "---"
+    puts "=> Job scheduled on #{options.inspect}"
+    puts "=> But executed on #{Time.now}"
+    puts "---"
+    puts
   end
 end

data/lib/qe.rb

@@ -1,6 +1,9 @@
 require "qe/action"
+require "qe/locale"
 require "qe/immediate"
 require "qe/version"
+require "qe/worker/class_methods"
+require "qe/worker/instance_methods"
 require "qe/worker"
 
 # In this wild world where a new asynchronous job processing
@@ -50,6 +53,16 @@ require "qe/worker"
 #     :name => "John Doe"
 #   })
 #
+# You can specify when this job must be processed by setting the <tt>:run_at</tt>
+# option.
+#
+#   MailerWorker.enqueue({
+#     :mail => :follow_up,
+#     :email => "john@example.org",
+#     :name => "John Doe",
+#     :run_at => 5.days.from_now
+#   })
+#
 # == Testing support
 #
 # Qe comes with testing support. Just require the <tt>qe/testing.rb</tt> file
@@ -77,4 +90,12 @@ module Qe
   class << self
     attr_accessor :adapter
   end
+
+  # Error that is raised when trying to use a feature
+  # that isn't supported by some adapter.
+  UnsupportedFeatureError = Class.new(StandardError)
+
+  # Error that is raised when trying to include a
+  # module before Qe::Worker is included.
+  OutOfOrderError = Class.new(StandardError)
 end

data/lib/qe/beanstalk.rb

@@ -15,6 +15,12 @@ module Qe
       Worker.queue worker.queue
       Backburner.enqueue Worker, worker.name, options
     end
+
+    def self.schedule(worker, run_at, options = {})
+      delay = run_at - Time.now
+      Worker.queue worker.queue
+      Backburner::Worker.enqueue Worker, [worker.name, options], :delay => delay
+    end
   end
 
   self.adapter = Beanstalk

data/lib/qe/delayed_job.rb

@@ -10,7 +10,14 @@ module Qe
     end
 
     def self.enqueue(worker, options = {})
-      Delayed::Job.enqueue Worker.new(worker.name, options), :queue => worker.queue
+      Delayed::Job.enqueue Worker.new(worker.name, options),
+        :queue => worker.queue
+    end
+
+    def self.schedule(worker, run_at, options = {})
+      Delayed::Job.enqueue Worker.new(worker.name, options),
+        :queue => worker.queue,
+        :run_at => run_at
     end
   end
 

data/lib/qe/locale.rb

@@ -0,0 +1,29 @@
+module Qe
+  module Locale
+    def self.included(base)
+      unless base.included_modules.include?(Qe::Worker)
+        raise OutOfOrderError, "must be included after Qe::Worker"
+      end
+
+      class << base
+        # Intercept <tt>Worker.enqueue</tt> method, adding
+        # the current locale to the options.
+        enqueue = instance_method(:enqueue)
+        define_method :enqueue do |options = {}|
+          options[:locale] = I18n.locale
+          enqueue.bind(self).call(options)
+        end
+      end
+
+      base.class_eval do
+        # Intercept <tt>Worker#before</tt> method, adding
+        # the setting the current locale.
+        before = instance_method(:before)
+        define_method :before do
+          I18n.locale = options.delete(:locale)
+          before.bind(self).call
+        end
+      end
+    end
+  end
+end

data/lib/qe/qu.rb

@@ -4,8 +4,6 @@ require "qu"
 module Qe
   class Qu
     class Worker
-      include ::Sidekiq::Worker
-
       def self.perform(*args)
         Qe::Worker.perform(*args)
       end
@@ -15,6 +13,10 @@ module Qe
       Worker.instance_variable_set("@queue", worker.queue)
       ::Qu.enqueue Worker, worker.name, options
     end
+
+    def self.schedule(*)
+      raise UnsupportedFeatureError, "scheduling isn't supported on Qu"
+    end
   end
 
   self.adapter = Qu

data/lib/qe/resque.rb

@@ -1,5 +1,6 @@
 require "qe"
 require "resque"
+require "resque_scheduler"
 
 module Qe
   class Resque
@@ -13,6 +14,12 @@ module Qe
       Worker.instance_variable_set "@queue", worker.queue
       ::Resque.enqueue Worker, worker.name, options
     end
+
+    def self.schedule(worker, run_at, options = {})
+      Worker.instance_variable_set "@queue", worker.queue
+
+      ::Resque.enqueue_at(run_at, Worker, worker.name, options)
+    end
   end
 
   self.adapter = Resque

data/lib/qe/sidekiq.rb

@@ -15,6 +15,11 @@ module Qe
       Worker.sidekiq_options :queue => worker.queue
       Worker.perform_async(worker.name, options)
     end
+
+    def self.schedule(worker, run_at, options = {})
+      Worker.sidekiq_options :queue => worker.queue
+      Worker.perform_at(run_at, worker.name, options)
+    end
   end
 
   self.adapter = Sidekiq

data/lib/qe/version.rb

@@ -1,3 +1,3 @@
 module Qe
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/qe/worker.rb

@@ -7,45 +7,6 @@ module Qe
       end
     end
 
-    module InstanceMethods
-      def initialize(options)
-        @options = options
-      end
-
-      # Return options that were provided when
-      # adding job to the queue.
-      def options
-        @options
-      end
-
-      # Set before hook.
-      def before
-      end
-
-      # Set after hook.
-      def after
-      end
-
-      # Set the error hook.
-      def error(error)
-        raise error
-      end
-    end
-
-    module ClassMethods
-      # Enqueue job on given worker class.
-      def enqueue(options = {})
-        Qe.adapter.enqueue(self, options)
-      end
-
-      # Set the queue name when receiving on argument.
-      # Return queue name otherwise.
-      def queue(*args)
-        @queue = args.first unless args.empty?
-        (@queue || :default).to_s
-      end
-    end
-
     # Find a worker by its name.
     # If worker constant is not found, raises a +NameError+
     # exception.

data/lib/qe/worker/class_methods.rb

@@ -0,0 +1,23 @@
+module Qe
+  module Worker
+    module ClassMethods
+      # Enqueue job on given worker class.
+      def enqueue(options = {})
+        run_at = options.delete(:run_at)
+
+        if run_at
+          Qe.adapter.schedule(self, run_at, options)
+        else
+          Qe.adapter.enqueue(self, options)
+        end
+      end
+
+      # Set the queue name when receiving on argument.
+      # Return queue name otherwise.
+      def queue(*args)
+        @queue = args.first unless args.empty?
+        (@queue || :default).to_s
+      end
+    end
+  end
+end

data/lib/qe/worker/instance_methods.rb

@@ -0,0 +1,28 @@
+module Qe
+  module Worker
+    module InstanceMethods
+      def initialize(options)
+        @options = options
+      end
+
+      # Return options that were provided when
+      # adding job to the queue.
+      def options
+        @options
+      end
+
+      # Set before hook.
+      def before
+      end
+
+      # Set after hook.
+      def after
+      end
+
+      # Set the error hook.
+      def error(error)
+        raise error
+      end
+    end
+  end
+end

data/qe.gemspec

@@ -22,6 +22,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency "delayed_job_active_record"
   s.add_development_dependency "backburner"
   s.add_development_dependency "resque"
+  s.add_development_dependency "resque-scheduler"
 
   s.add_development_dependency "activerecord"
   s.add_development_dependency "awesome_print"

data/spec/qe/beanstalk_spec.rb

@@ -42,4 +42,33 @@ describe Qe::Beanstalk do
       Qe::Beanstalk.enqueue(worker, :a => 1)
     end
   end
+
+  context "scheduling" do
+    let(:worker) {
+      mock("worker", :queue => "some_queue", :name => "SomeWorker")
+    }
+
+    let(:date) { Time.parse("2012-12-05 02:00:00") }
+
+    before do
+      Time.stub :now => date - 3600
+      Backburner::Worker.stub :enqueue
+    end
+
+    it "sets queue name" do
+      Qe::Beanstalk::Worker
+        .should_receive(:queue)
+        .with("some_queue")
+
+      Qe::Beanstalk.schedule(worker, date, :a => 1)
+    end
+
+    it "schedules job" do
+      ::Backburner::Worker
+        .should_receive(:enqueue)
+        .with(Qe::Beanstalk::Worker, ["SomeWorker", :a => 1], :delay => 3600)
+
+      Qe::Beanstalk.schedule(worker, date, :a => 1)
+    end
+  end
 end

data/spec/qe/delayed_job_spec.rb

@@ -56,4 +56,43 @@ describe Qe::DelayedJob do
       Qe::DelayedJob.enqueue(worker, :a => 1)
     end
   end
+
+  context "scheduling" do
+    let(:worker) {
+      mock("worker", :queue => "some_queue", :name => "SomeWorker")
+    }
+
+    let(:date) { Time.now }
+
+    before do
+      Delayed::Job.stub :enqueue
+    end
+
+    it "sets queue name" do
+      Delayed::Job
+        .should_receive(:enqueue)
+        .with(anything, hash_including(:queue => "some_queue"))
+
+      Qe::DelayedJob.schedule(worker, date, :a => 1)
+    end
+
+    it "instantiates worker" do
+      Qe::DelayedJob::Worker
+        .should_receive(:new)
+        .with("SomeWorker", :a => 1)
+
+      Qe::DelayedJob.schedule(worker, date, :a => 1)
+    end
+
+    it "schedules job" do
+      job = mock("job")
+      Qe::DelayedJob::Worker.stub :new => job
+
+      Delayed::Job
+        .should_receive(:enqueue)
+        .with(job, hash_including(:run_at => date))
+
+      Qe::DelayedJob.schedule(worker, date, :a => 1)
+    end
+  end
 end

data/spec/qe/enqueue_matcher_spec.rb

@@ -1,8 +1,6 @@
 require "spec_helper"
 
 describe Qe::EnqueueMatcher do
-  HelloWorker = Class.new { include Qe::Worker }
-
   it "sets adapter" do
     expect(Qe.adapter).to eql(Qe::Testing)
   end

data/spec/qe/immediate_spec.rb

@@ -1,11 +1,6 @@
 require "spec_helper"
 
 describe Qe::Immediate do
-  HelloWorker = Class.new do
-    include Qe::Worker
-    def perform; end
-  end
-
   let(:job) { mock("job").as_null_object }
 
   it "sets options" do

data/spec/qe/locale_spec.rb

@@ -0,0 +1,58 @@
+require "spec_helper"
+
+describe Qe::Locale do
+  let(:i18n) { mock("I18n", :locale => :en) }
+
+  before do
+    stub_const("I18n", i18n)
+  end
+
+  context "when including extension" do
+    context "before Qe::Locale" do
+      it "raises exception" do
+        expect {
+          mod = Module.new do
+            include Qe::Locale
+          end
+        }.to raise_error(Qe::OutOfOrderError)
+      end
+    end
+
+    context "after Qe::Locale" do
+      it "does nothing" do
+        expect {
+          mod = Module.new do
+            include Qe::Worker
+            include Qe::Locale
+          end
+        }.not_to raise_error
+      end
+    end
+  end
+
+  context "when enqueuing" do
+    before do
+      Qe.adapter = Qe::Testing
+    end
+
+    it "sets locale" do
+      expect {
+        LocalizedWorker.enqueue
+      }.to enqueue(LocalizedWorker).with(:locale => :en)
+    end
+  end
+
+  context "when performing" do
+    before do
+      Qe.adapter = Qe::Immediate
+    end
+
+    it "sets locale" do
+      i18n
+        .should_receive(:locale=)
+        .with(:en)
+
+      LocalizedWorker.enqueue
+    end
+  end
+end

data/spec/qe/qu_spec.rb

@@ -39,4 +39,12 @@ describe Qe::Qu do
       Qe::Qu.enqueue(worker, :a => 1)
     end
   end
+
+  context "scheduling" do
+    it "raises exception" do
+      expect {
+        Qe::Qu.schedule(stub, Time.now, :a => 1)
+      }.to raise_error(Qe::UnsupportedFeatureError)
+    end
+  end
 end

data/spec/qe/resque_spec.rb

@@ -39,4 +39,29 @@ describe Qe::Resque do
       Qe::Resque.enqueue(worker, :a => 1)
     end
   end
+
+  context "scheduling" do
+    let(:date) { Time.now }
+
+    let(:worker) {
+      mock("worker", :queue => "some_queue", :name => "SomeWorker")
+    }
+
+    before do
+      Resque.stub :enqueue_at => nil, :remove_delayed => nil
+    end
+
+    it "sets queue name" do
+      Qe::Resque.schedule(worker, date)
+      expect(Qe::Resque::Worker.instance_variable_get("@queue")).to eql("some_queue")
+    end
+
+    it "schedules job" do
+      ::Resque
+        .should_receive(:enqueue_at)
+        .with(date, Qe::Resque::Worker, "SomeWorker", :a => 1)
+
+      Qe::Resque.schedule(worker, date, :a => 1)
+    end
+  end
 end

data/spec/qe/sidekiq_spec.rb

@@ -46,4 +46,32 @@ describe Qe::Sidekiq do
       Qe::Sidekiq.enqueue(worker, :a => 1)
     end
   end
+
+  context "scheduling" do
+    let(:worker) {
+      mock("worker", :queue => "some_queue", :name => "SomeWorker")
+    }
+
+    before do
+      Qe::Sidekiq::Worker.stub :perform_at
+    end
+
+    it "sets queue name" do
+      Qe::Sidekiq::Worker
+        .should_receive(:sidekiq_options)
+        .with(:queue => "some_queue")
+
+      Qe::Sidekiq.enqueue(worker)
+    end
+
+    it "schedules job" do
+      date = Time.now
+
+      Qe::Sidekiq::Worker
+        .should_receive(:perform_at)
+        .with(date, "SomeWorker", :a => 1)
+
+      Qe::Sidekiq.schedule(worker, date, :a => 1)
+    end
+  end
 end

data/spec/qe/worker_spec.rb

@@ -1,12 +1,6 @@
 require "spec_helper"
 
 describe Qe::Worker do
-  HelloWorker = Class.new do
-    include Qe::Worker
-
-    def perform; end
-  end
-
   it "sets queue name" do
     HelloWorker.queue "hello"
     expect(HelloWorker.queue).to eql("hello")
@@ -28,6 +22,18 @@ describe Qe::Worker do
     HelloWorker.enqueue(:a => 1)
   end
 
+  it "delegates scheduling to adapter" do
+    adapter = mock("adapter")
+    date = Time.now
+    adapter
+      .should_receive(:schedule)
+      .with(HelloWorker, date, :a => 1)
+
+    Qe.adapter = adapter
+
+    HelloWorker.enqueue(:a => 1, :run_at => date)
+  end
+
   it "finds worker by its name" do
     worker = mock("worker")
     stub_const "Some::Weird::Worker", worker
@@ -73,8 +79,13 @@ describe Qe::Worker do
     end
 
     it "passes error object to error handler" do
-      HelloWorker.any_instance.should_receive(:error).with(kind_of(StandardError))
-      HelloWorker.any_instance.stub(:perform).and_raise("ZOMG!")
+      HelloWorker.any_instance
+        .should_receive(:error)
+        .with(kind_of(StandardError))
+
+      HelloWorker.any_instance
+        .stub(:perform)
+        .and_raise("ZOMG!")
 
       Qe::Worker.perform("HelloWorker", {})
     end

data/spec/spec_helper.rb

@@ -10,3 +10,6 @@ require "qe/sidekiq"
 require "qe/qu"
 require "qe/delayed_job"
 require "delayed_job_active_record"
+
+require "support/hello_worker"
+require "support/localized_worker"

data/spec/support/hello_worker.rb

@@ -0,0 +1,4 @@
+class HelloWorker
+  include Qe::Worker
+  def perform; end
+end

data/spec/support/localized_worker.rb

@@ -0,0 +1,5 @@
+class LocalizedWorker
+  include Qe::Worker
+  include Qe::Locale
+  def perform; end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: qe
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-17 00:00:00.000000000 Z
+date: 2013-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sidekiq
@@ -91,6 +91,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: resque-scheduler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
@@ -191,11 +207,12 @@ files:
 - examples/Procfile
 - examples/README.md
 - examples/Rakefile
+- examples/add_jobs.rb
 - examples/beanstalkd.ru
+- examples/delayed_job.ru
 - examples/migrate.rb
 - examples/redis.conf
 - examples/resque.ru
-- examples/sample.rb
 - examples/sidekiq.ru
 - examples/workers.rb
 - lib/qe.rb
@@ -203,6 +220,7 @@ files:
 - lib/qe/beanstalk.rb
 - lib/qe/delayed_job.rb
 - lib/qe/immediate.rb
+- lib/qe/locale.rb
 - lib/qe/qu.rb
 - lib/qe/resque.rb
 - lib/qe/sidekiq.rb
@@ -210,17 +228,22 @@ files:
 - lib/qe/testing/rspec.rb
 - lib/qe/version.rb
 - lib/qe/worker.rb
+- lib/qe/worker/class_methods.rb
+- lib/qe/worker/instance_methods.rb
 - qe.gemspec
 - spec/qe/action_spec.rb
 - spec/qe/beanstalk_spec.rb
 - spec/qe/delayed_job_spec.rb
 - spec/qe/enqueue_matcher_spec.rb
 - spec/qe/immediate_spec.rb
+- spec/qe/locale_spec.rb
 - spec/qe/qu_spec.rb
 - spec/qe/resque_spec.rb
 - spec/qe/sidekiq_spec.rb
 - spec/qe/worker_spec.rb
 - spec/spec_helper.rb
+- spec/support/hello_worker.rb
+- spec/support/localized_worker.rb
 homepage: http://rubygems.org/gems/qe
 licenses: []
 post_install_message: 
@@ -241,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: A simple interface over several background job libraries like Resque, Sidekiq