The goal of Venom is to provide a project structure for using Symbiont, Watir-WebDriver, and Cucumber.


Add this line to your application's Gemfile:

gem 'venom'

And then execute:

$ bundle

Or install it yourself as:

$ gem install venom


The easiest way to use Venom would be to have it generate the default structure for you:

$ venom workshop project-spec

This command will create a workshop (project) structure with the directory name as project-spec. You can also indicate that you want a separate library (which I recommend).

$ venom workshop project-spec --library

What this does is allow the project to have a separate library (lib) directory. The reason you might do this is to keep your specifications (feature files) separate from various aspects of implementation.

You can also indicate that you want the browser to restart after every scenario is executed.

$ venom workshop project-spec --restart

This is as opposed to using the same browser for the entire feature file.

You can, of course, chain these options together.

$ venom workshop project-spec --library --restart


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request