Find file
Fetching contributors…
Cannot retrieve contributors at this time
152 lines (100 sloc) 5.01 KB

Build Status


Perform later is a gem meant to work with the Resque queue system.

Usually, when working with Resque, you need separate "Worker" classes and you also need to do Resque.enqueue whenever you want to add a task to the queue.

That can be a real hassle if you are adding Resque to an existing project, it can also add quite a bit of code to your system.

perform_later fills this need, it offers a suite to handle all of your queuing needs, both for Objects and for ActiveRecord models.


Why should you queue something for later?

You should queue something whenever the method handles some heavy lifting, some timely actions like API, 3rd party HTTP requests and more.

The basic logic is that whatever you don't need to do NOW, you should do later, this will make your site faster and the users will feel it.

Real life use case

At Gogobot whenever you post a review, there's major score calculation going on. This can sometimes take up to a minute, depending on the user graph.

The user should not wait for this on submit, it can be queued into later execution.


gem install perform_later

If you are using bundler, simply add gem "perform_later" to your Gemfile


In an initializer, all you need to say is whether you want perform later to be enabled or not, typically, it will be something like this

unless Rails.env.test?
  PerformLater.config.enabled = true # this will default to false if unset



perform_later comes with a special method you can use on ActiveRecord models.

	class User < ActiveRecord::Base
	  def long_running_method
	    # Your code here
	  later :long_running_method
	  def long_running_method_2
	    # Your code here
	  later :long_running_method_2, queue: :some_queue_name
	  def lonely_long_running_method
	    # Your code here
	  later :lonely_long_running_method, :loner => true, queue: :some_queue_name
	u = User.find(some_user_id)
	u.long_running_method # Method will be queued into the :generic queue
	u.long_running_method_2 # Method will be queued into :some_queue_name queue
	u.lonely_long_running_method # Method will be queued into the :some_queue_name queue, only a single instance of this method can exist in the queue.

You can of course choose to run the method off the queue, just prepend now_ to the method name and it will be executed in sync.

	u = User.find(some_user_id)


If you want object methods to be queued, you will have to use the perform_later special method.

	class SomeClass
		def some_heavy_lifting_method
	  	  # Your code here
		def some_more_heavy_lifting(user_id)
	  	  # Your code here
	SomeClass.perform_later(:queue_name, :some_heavy_lifting_method)
	SomeClass.perform_later(:queue_name, :some_more_heavy_lifting, user_id)

If you want the method to be a loner (only a single instance in the queue), you will need to use the perform_later! method.

	SomeClass.perform_later!(:queue_name, :some_more_heavy_lifting, user_id)

The params parser

perform_later has a special class called ArgsParser, this class is in charge of translating the args you are passing into params that can actually be serialized to JSON cleanly.


	user = User.find(1)
	PerformLater::ArgsParser.params_to_resque(user) => 'AR:#User:1'
	hotel = Hotel.find(1)
	PerformLater::ArgsParser.params_to_resque(hotel) => 'AR:#Hotel:1'
	hash = { name: "something", other: "something else" }
	=> ---
		:name: something
		:other: something else
	# Hashes are translated into YAML

Basically, the ArgsParser class allows you to keep passing any args you want to your methods without worrying about whether they serialize cleanly or not.

ArgsParser also patched resque-mailer so you can pass in AR objects to mailers as well.

Contribute / Bug reports

If you have an issue with this gem, please open an issue in the main repo, it will help tons if you could supply a failing spec with that, so I can better track where the bug is coming from, if not, no worries, just report I will do my best to address it as fast and efficient as I can.

If you want to contribute (awesome), open a feature branch, base it on master.

Be as descriptive as you can in the pull request description, just to be clear what problem you are solving or what feature are you adding.


Avi Tzurel (@kensodev)


Felipe did awesome work on making sure perform_later can work with any args and any number of args passed into the methods. Felipe now has commit rights to the repo.