rosette-queue-resque

Wraps the Resque queuing library and allows Rosette jobs to be enqeued and monitored.

Installation

gem install rosette-queue-resque

Then, somewhere in your project:

require 'rosette/queuing/resque-queue'

Introduction

This library is generally meant to be used with the Rosette internationalization platform that extracts translatable phrases from git repositories. rosette-queue-resque is capable of processing Rosette jobs on a Resque queue. It offers a way to enqueue jobs, start up workers to process them, and monitor them via Resque web.

Usage with rosette-server

Let's assume you're configuring an instance of Rosette::Server. Adding Resque support would cause your configuration to look something like this:

# config.ru
require 'rosette/core'
require 'rosette/queuing/resque-queue'

rosette_config = Rosette.build_config do |config|
  config.use_queue('resque') do |config|
    config.set_queue_options(host: 'localhost', port: 6379)
  end
end

server = Rosette::Server::ApiV1.new(rosette_config)
run server

You can also add resque web support to monitor and control jobs:

builder = Rosette::Server::Builder.new
server = Rosette::Server::ApiV1.new(rosette_config)

builder.mount('/', api_server)
builder.mount('/resque', Resque::Server)

run builder.to_app

You may want to protect your resque interface from outsiders. Here's a quick-n-dirty way to do it with HTTP basic auth:

resque_server = Rack::Builder.new do
  map '/' do
    use(Rack::Auth::Basic, "Protected Area") do |username, password|
      allowed_username = ENV['RESQUE_WEB_USERNAME']
      allowed_password = ENV['RESQUE_WEB_PASSWORD']
      username == allowed_username && password == allowed_password
    end

    run Resque::Server
  end
end

builder = Rosette::Server::Builder.new
server = Rosette::Server::ApiV1.new(rosette_config)

builder.mount('/', api_server)
builder.mount('/resque', resque_server)

run builder.to_app

Requirements

This project must be run under jRuby. It uses expert to manage java dependencies via Maven. Run bundle exec expert install in the project root to download and install java dependencies.

Running Tests

bundle exec rake or bundle exec rspec should do the trick.

Authors

• Cameron C. Dutro: http://github.com/camertron