Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Resque-based web poller
Ruby CoffeeScript HTML JavaScript CSS
branch: master

Merge pull request #4 from lumoslabs/rails_compatibility

Update travis, gemspec for different rails versions
latest commit 1acc1b06f6
@agau4779 agau4779 authored
Failed to load latest commit information.
app remove sslrequirement
config Initial commit
lib merge master
script Initial commit
spec remove deprecated methods
.gitignore Initial commit
.travis.yml
Gemfile add poltergeist for konacha
MIT-LICENSE Update license info
README.md merge master
Rakefile Initial commit
resque-poll.gemspec merge master

README.md

Build Status

resque-poll

resque-poll is a Rails engine that allows you to easily do long polling for Resque jobs. resque-poll depends on resque-status.

Installation

Include resque-poll in your Gemfile:

gem 'resque-poll'

Mount the engine in your routes.rb:

mount ResquePoll::Engine => '/resque_poll'

Require the javascript files & the dependencies inyour application.js javascript file (requires Asset Pipeline):

//= require jquery
//= require resque_poll

Usage

In a form, the data-resque-poll attribute to your form tag:

<%= form_for @movie, html: { data: { 'resque-poll' => true } } do |f| %>
  <%= f.input :title %>
  <%= f.submit %>

Your controller can then use ResquePoll to return the appropriate response to begin polling:

class MoviesController < ApplicationController
  def create
    poll = ResquePoll::Job.create(LongRunningMoveJob, {title: params[:title]})
    render json: poll.to_json
  end
end

resque-poll will fire events when the polling has completed (successfully or unsuccessfully). To make use of this, you can hook into the triggered events and take action on them. Any data passed back from the resque job will also be available to you in the response.

The following events are fired:

  • resque:poll:stopped - fired when processing has finished successfully or unsuccessfully
  • resque:poll:success - fired when processing has finished successfully
  • resque:poll:stopped - fired when processing has finished unsuccessfully

Continuing with our form from above:

$('form')
  .bind('resque:poll:stopped', function(event, response) {
    console.log('Processing finished!');
  }).bind('resque:poll:success', function(event, response) {
    console.log('Processing successful!');
  }).bind('resque:poll:error', function(event, response) {
    console.log('Processing failed!');
  });

Since a common use case would be to enable/disable the submit button during the course of processing the background job, the resque-poll-disable-with attribute can be used to automatically disable/enable a button with a given value when processing has begun or completed.

<%= f.submit :'data-resque-poll-disable-with' => 'Creating...' %>

Dependencies

resque-poll's latest version, 2.0.0, is dependent on Rails 4.0.0. It is not backwards-compatible with Rails 3. For the Rails 3 compatible version of resque-poll, please downgrade to 1.0.1.

Something went wrong with that request. Please try again.