Skip to content
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.