protoc / fist_of_fury

Recurring jobs for Sucker Punch

Fist of Fury

Recurring jobs for Sucker Punch.

Why

Sucker Punch offers the ability to run background jobs within the web server process. Yes, this means you can host your app on Heroku without paying for an extra dyno for background jobs. However, Sucker Punch does not implement recurring jobs. Enter Fist of Fury!

What

Fist of Fury is heavily inspired by Sidetiq for Sidekiq. It uses the ice_cube gem for easy creation of recurrence rules.

Installation

Add this line to your application's Gemfile:

gem 'fist_of_fury', '~> 0.2.0'

And then execute:

$ bundle

Or install it yourself as:

$ gem install fist_of_fury

Rails

Run the install generator, which installs an initializer:

$ rails generate fist_of_fury:install

Usage

You can schedule your jobs within the jobs themselves:

class SayHiJob
  include SuckerPunch::Job
  include FistOfFury::Recurrent

  recurs { minutely }

  def perform
    Rails.logger.info 'Hi!'
  end
end

If you did not run the install generator, you need to kick off the process somewhere (like an initializer) with this:

FistOfFury.attack!

You can specify the recurrence rules during kickoff:

FistOfFury.attack! do
  LogJob.recurs { secondly(3) }
end

Configuration Options

FistOfFury.configure do |config|
  config.utc = true # false by default; makes all time within Fist of Fury UTC
end

Contributing

1. Fork it ( http://github.com/facto/fist_of_fury/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request