FUCK SETI. Run specs with your spare CPU cycles.
Distribute your spec suite amongst your LAN via Bonjour.
- Spin up a manager on each machine that can run your specs.
- Start a dispatcher in your project directory.
- Say farewell 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
specjour on the command-line will start a manager which advertises that it's ready to run specs. By default, the manager will only use one worker to run yours specs. If you had 4 cores however, you could use
specjour --workers 4 to run 4 sets of specs at once.
Setup the dispatcher
Require specjour's rake tasks in your project's
Distribute the specs
Run the rake task to distribute the specs among the managers you started.
$ rake specjour
Distribute the features
Run the rake task to distribute the features among the managers you started.
$ rake specjour:cucumber
Edit your config/environment.rb
Each worker should run their specs in an isolated database. Modify the test database name in your
config/database.yml to include the following environment variable (Influenced by parallel_tests):
test: database: blog_test<%=ENV['TEST_ENV_NUMBER']%>
Each worker will attempt to clear its database tables before running any specs via
DELETE FROM <table_name>;. Additionally, test databases will be created if they don't exist (i.e.
CREATE DATABASE blog_test8 for the 8th worker) and will load your schema when it has fallen behind.
Only listen to supported projects
By default, a manager will listen to all projects trying to distribute specs over the network. Sometimes you'll only want a manager to respond to one specific spec suite. You can accomplish this with the
$ specjour --projects bizconf # only run specs for the bizconf project
You could also listen to multiple projects:
$ specjour --projects bizconf,workbeast # only run specs for the bizconf and workbeast projects
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.