Build Status

Overview

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?

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.

Installation

gem install perform_later

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

Configuration

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
end

Usage

ActiveRecord

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


    class User < ActiveRecord::Base
      def long_running_method
        # Your code here
      end
      later :long_running_method

      def long_running_method_2
        # Your code here
      end
      later :long_running_method_2, queue: :some_queue_name

      def lonely_long_running_method
        # Your code here
      end
      later :lonely_long_running_method, :loner => true, queue: :some_queue_name
    end

    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)
    u.now_long_running_method

Objects/Classes

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
        end

        def some_more_heavy_lifting(user_id)
          # Your code here
        end     
    end

    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.

Examples:

    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" }
    PerformLater::ArgsParser.params_to_resque(hash) 
    => ---
        :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.

The custom finder

I found the need to add a custom finder to the args parser.

Why?

At Gogobot for example, we use slave databases, those sometimes have lag, so when the finder is executed it returns nil, even though the record is actually on the master.

So, I added support for custom finders.

Example:

    class CustomFinder
        def self.find(klass, id)
            Octopus.using(:master) {
                klass.where(id: id).first
            } unless klass.where(id: id).first
        end
    end

Then in an initializer

    PerformLater::Plugins.add_finder(CustomFinder)

So, at Gogobot for example, we will fall back to master if the record was not found on the slave DB.

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.

Author

Avi Tzurel (@kensodev) http://www.kensodev.com

Contributors

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.