Woro

Write once, run once.

Manage one-time remote tasks in your Rails project. Plugins with Mina and Capistrano to add support for rake tasks hosted in remote collection, such as Gist.

Say you have a data migration to perform on a remote server. The procedure is too complex to just do it in the remote console and using database migrations would be evil. A rake task would be nice, but checking this in with the source code repository adds clutter, as you know you will only run this once. Woro offers a quick way of pushing rake tasks onto the remote server, execute them and delete them instantly. Using Github's gist, you keep version control of the tasks and can share them with colleagues.

Woro helps you create rake tasks, that you can develop and run locally. Once you are ready, woro let's you push them online to a remote collection like Gist. Using a mina deployment setup, these tasks are downloaded on the remote system, executed by rake and cleaned up afterwards.

Installation

Add this line to your application's Gemfile:

gem 'woro', require: false

And then execute:

$ bundle

Or install it yourself as:

$ gem install woro

Then run:

$ woro init

This will create lib/woro_tasks/ folder and lib/tasks/woro.rake. Here the Woro task files are stored, edited locally and run using rake.

for use with Mina

Require mina/woro in your config/deploy.rb:

require 'mina/bundler'
require 'mina/rails'
require 'mina/git'
require 'mina/woro'

...

for use with Capistrano

Require capistrano/woro in your config/deploy.rb:

require 'capistrano/rails'
require 'capistrano/woro'

...

Usage

$ woro new cleanup_users

Can be used to create the template for a new task in lib/woro_tasks/.

The task itself is a regular rake-task in the woro-namespace. You can test it locally using rake:

$ rake woro:cleanup_users

Once you are done writing the task and you want to execute it on the remote system. First you have to push them online, in this case to Gist.

$ woro push gist:cleanup_users

Attention, depending on whether you set up a Gist/Github login on initialization. These tasks are online anonymous, but public, or private under the specified Github account.

Now, to run a task remotely using Mina, specify the task:

$ mina woro:run task=gist:cleanup_users

Or to run it with Capistrano:

$ cap woro:run task=gist:cleanup_users

To show a list of all tasks uploaded to any collection do:

$ woro list
$ woro ls

And finally you can download an existing task to your local woro tasks directory.

$ woro pull gist:cleanup_users

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request