This code is provided on an "AS-IS” basis without warranty of any kind, either express or implied, including without limitation any implied warranties of condition, uninterrupted use, merchantability, fitness for a particular purpose, or non-infringement. Your tests and testing environments may require you to modify this project. For questions regarding Sauce Labs integration, please see the Sauce Labs documentation. This project is not maintained by Sauce Labs Support.

This is the recommended place to start if you want to create a new project in Ruby. If you already have an existing test suite and are just looking to add Sauce Labs functionality to that project, or if you need to run tests on a mobile application, take a look at the Ruby Example Tests project.

1. Pass Information to Saucelabs
2. Execute Tests in Parallel
3. Integrate with Applitools
4. Watir Drops Example
5. Watir Model Example

1. Pass Information to Saucelabs
2. Execute Tests in Parallel
3. Integrate with Applitools
4. Page Object Example
5. Data Magic Example

1. Global Dependencies

   • Install Ruby
   • If on Mac install Ruby with Homebrew

   $ brew install ruby
   

   • Install Rake

   $ gem install rake
   

   • Install bundler (Sudo may be necessary)

   $ gem install bundler
   

2. Sauce Credentials

   • In the terminal export your Sauce Labs Credentials as environmental variables:

   $ export SAUCE_USERNAME=<your Sauce Labs username>
   $ export SAUCE_ACCESS_KEY=<your Sauce Labs access key>
   

   If you don't do this, the Rakefile will complain.

3. Project Dependencies

   • Install packages (Use sudo if necessary)

   $ bundle install
   

   • Set Build ID (Optional)

   $ export BUILD_TAG=sauce_automated_build_name
   

1. Run RSpec specs on Sauce in Parallel:

   $ bundle exec rake test_rspec
   

2. Run Cucumber Features on Sauce in Parallel:

   $ bundle exec rake clean test_cucumber
   

3. Execute Tests on Sauce in Parallel using an environment variable:

   $ TEST_RUNNER=rspec bundle exec rake
   

View the results on your Sauce Labs Dashboard

This project is open source! The maintainers welcome the community to submit an issue with ideas or bug reports, and making pull requests with bug fixes and suggested code improvements

This project is available under the terms of the MIT License.

• A great resource to search for issues not explicitly covered by documentation.