Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Sauce OnDemand is a Selenium testing cloud service, developed by Sauce Labs Inc (saucelabs.com). This is the Ruby client adapter for Sauce OnDemand.
Ruby Shell JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
examples
gemfiles
gems
generators/sauce
lib
spec
support
test
.document
.gitignore
Gemfile
LICENSE
README.markdown
Rakefile
sauce.gemspec

README.markdown

Sauce OnDemand for Ruby

Build Status

Sauce OnDemand is a Selenium-based browser testing service offered by Sauce Labs.

Installation

    % gem install sauce

Suggested Toolchain

The Sauce gem has been optimized to work most effectively with Cucumber and Capybara.

You can read more about how to get started with Cucumber and Capybara on this wiki page.

Legacy Rails Integration

You can use either RSpec or Test::Unit with Rails and Sauce OnDemand. To get started, run the generator:

script/generate sauce USERNAME ACCESS_KEY

The generator will take care of setting up your helpers with Sauce OnDemand configuration, which you can tweak inside the Sauce.config block if necessary.

Example RSpec test for Rails

Here's an example test for RSpec. Drop something like this in spec/selenium/example.rb. (Because of the way RSpec categorizes tests, the "spec/selenium" directory tree is required for the integration to work properly):

require "spec_helper"

describe "my app" do
  it "should have a home page" do
    s.get 'http://localhost:3001/'
    assert s.page_source.include? 'Welcome aboard'
  end
end

Here's how you run RSpec tests with Sauce OnDemand using rake:

rake spec:selenium:sauce

Example Test::Unit test for Rails

Here's an example test for Test::Unit. Drop something like this in test/selenium/example_test.rb:

require "test_helper"

class DemoTest < Sauce::RailsTestCase
  test "my app", do
    s.get 'http://localhost:3001/'
    assert s.page_source.include? 'Welcome aboard'
  end
end

Here's how you run Test::Unit tests with Sauce OnDemand using rake:

rake test:selenium:sauce

Contributing to the Gem

  • Fork the project.
  • Make your feature addition or bug fix.
  • Please add RSpec tests for your changes, as we don't create a new release of the gem unless all tests are passing.
  • Commit
  • Send a pull request. Bonus points for topic branches.

Testing the Gem

Running the full test suite will require RVM

  • Set SAUCE_USERNAME and SAUCE_ACCESS_KEY in your environment to valid Sauce OnDemand credentials
  • bundle install
  • rake spec:unit # Will just run the unit tests
  • rake test # Will run all the tests and can be slow
Something went wrong with that request. Please try again.