The Selenium Conf Ruby/RSpec/Capybara workshop
Ruby Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Selenium Conference Workshop

Welcome to Etsy's 2012 Selenium Conference workshop! This repository contains the slides, setup and RSpec skeleton for writing some automated tests against the Etsy website.

This repository can be reached by visiting and this readme can be reached by visiting


Perform the following steps to make sure you are all setup and ready for the workshop. Not to worry if you get stuck, we can assist you or pair you up with somebody.

The more that can be done before the workshop, the more time we'll have to play.

Ruby & Firefox

You should make sure the following dependencies are installed before the session begins...

To check whether Ruby is installed, try ruby -v. Versions newer than 1.8.7 should work fine, as should 1.8.6. If it is installed, you can skip to Libraries & Verification.

Installing Ruby for Linux


  • apt-get install ruby
  • yum install ruby.

Installing Ruby for OS X

Xcode is a prerequisite for most development on OS X so you should install that first. To install Ruby, either...

  • brew install ruby.
  • port install ruby

Installing Ruby for Windows

Click here to begin downloading the Ruby installer.

Make sure that you select "Add Ruby executables to your PATH" when choosing the destination path.

Libraries & Verification

Once Ruby and Firefox are installed, perform the following steps to install the Ruby libraries and tests...

  • Either clone this repository with Git (git clone git:// or download the latest zipped version from here.
  • Run sh (Linux & OS X) or setup.bat (Windows) to install the required Ruby libraries (or run the commands listed in the respecitve file).
  • Try running the (currently failing) tests: bundle e rspec.

How to run...

Commands should be prefixed with bundle e. This ensures the libraries installed in the previous setup are used.

  • To run all tests: bundle e rspec.
  • To run all tests from a single file: bundle e rspec spec/example_spec.rb.
  • To run a single test, specify the file and line number, add ':number' to the end of the filename: bundle e rspec spec/example_spec.rb:11.

Some links!

For future reference, here are some handy links...

  • Ruby (the programming language).
  • RSpec (the test framework).
  • Capybara (how the tests drive the browser).