Sauce for Ruby
This is the Ruby client adapter for testing with Sauce Labs, a Selenium-based browser testing service.
There is more information on the wiki, so be sure to look there for information too!
% gem install sauce
To get started with Sauce and Cucumber, install the appropriate gem:
% gem install sauce-cucumber
And then read more how to get started with Cucumber and Capybara on this wiki page.
Running on against a list of browsers
To run against a list of browsers, you need to configure them:
Sauce.config do |c| c.browsers = [ ["windows","firefox","18"], ["windows","opera","11"] ] end
Then, depending on your test framework:
Place your specs in the
Give your tests a :type of :selenium, eg
describe Aioli, :type => :selenium do
Tests will be run against each combination, sequentially and automagically.
Contributing to the Gem
- Fork the GitHub project
- Create a branch to perform your work in, this will help make your pull request more clear.
- Write some RSpec tests to demonstrate your desired capability or exhibit the bug you're fixing.
- Make your feature addition or bug fix.
- Send a pull request! :)
Testing the Gem
Running the full test suite will require RVM
SAUCE_ACCESS_KEYin your environment to valid Sauce credentials or create an
ondemand.ymlin the following format:
access_key: <yourkeyhere> username: <yourusernamehere>
bundle installto install the gems necessary to work with the Sauce gem
rake spec:unitwill run the RSpec unit tests
If you'd like to run the entire test suit,
rake testwill run all the integration tests, but requires the Sauce credentials to be set up properly as these tests will run actual jobs on Sauce.