Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

48 lines (31 sloc) 1.54 KB


Distribute your spec suite amongst your LAN via Bonjour.

  1. Start a dispatcher in your project directory.
  2. Spin up a manager on each remote machine.
  3. Say "goodbye" to your long coffee breaks.


  • Bonjour or DNSSD (the capability and the gem)
  • Rsync (system command used)
  • Rspec (officially v1.3.0)


gem install specjour

Start a manager

Running specjour on the command-line will start a manager which advertises that it's ready to run tests. By default, the manager will only use one worker to run the tests. If you had 4 cores however, you could use specjour --workers 4 to run 4 sets of tests at once.

$ specjour

Setup the dispatcher

Add the rake task to the Rakefile in your project's directory.

require 'specjour/tasks/specjour'

Distribute the tests

Run the rake task in your project directory to start the test suite.

$ rake specjour

The worker reports passes/failures in batches of 25 so you won't get immediate feedback, override the batch size via specjour --batch-size 1

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


Copyright (c) 2010 Sandro Turriate. See MIT_LICENSE for details.

Jump to Line
Something went wrong with that request. Please try again.