Contents

require 'sidekiq/client'

module Sidekiq

  ##
  # Include this module in your worker class and you can easily create
  # asynchronous jobs:
  #
  # class HardWorker
  #   include Sidekiq::Worker
  #
  #   def perform(*args)
  #     # do some work
  #   end
  # end
  #
  # Then in your Rails app, you can do this:
  #
  #   HardWorker.perform_async(1, 2, 3)
  #
  # Note that perform_async is a class method, perform is an instance method.
  module Worker
    def self.included(base)
      base.extend(ClassMethods)
    end

    module ClassMethods
      def perform_async(*args)
        Sidekiq::Client.push('class' => self, 'args' => args)
      end

      def queue(name)
        puts "DEPRECATED: `queue :name` is now `sidekiq_options :queue => :name`"
        Sidekiq::Client.queue_mappings[self.name] = name.to_s
      end

      ##
      # Allows customization for this type of Worker.
      # Legal options:
      #
      #   :unique - enable the UniqueJobs middleware for this Worker, default *true*
      #   :queue - use a named queue for this Worker, default 'default'
      #   :retry - enable the RetryJobs middleware for this Worker, default *true*
      def sidekiq_options(opts={})
        @sidekiq_options = get_sidekiq_options.merge(stringify_keys(opts || {}))
      end

      def get_sidekiq_options # :nodoc:
        @sidekiq_options || { 'unique' => true, 'retry' => true, 'queue' => 'default' }
      end

      def stringify_keys(hash) # :nodoc:
        hash.keys.each do |key|
          hash[key.to_s] = hash.delete(key)
        end
        hash
      end
    end
  end
end

Version data entries

7 entries across 7 versions & 1 rubygems

Version	Path
sidekiq-1.1.2	lib/sidekiq/worker.rb
sidekiq-1.1.1	lib/sidekiq/worker.rb
sidekiq-1.1.0	lib/sidekiq/worker.rb
sidekiq-1.0.0	lib/sidekiq/worker.rb
sidekiq-0.11.2	lib/sidekiq/worker.rb
sidekiq-0.11.1	lib/sidekiq/worker.rb
sidekiq-0.11.0	lib/sidekiq/worker.rb