Sauce OnDemand is a Selenium testing cloud service, developed by Sauce Labs Inc (saucelabs.com). This is the Ruby client adapter for Sauce OnDemand.

Features

Install

gem install sauce

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:

require "spec_helper"

describe "my app" do
  it "should have a home page" do
    page.open "/"
    page.is_text_present("Welcome Aboard").should be_true
  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.rb:

require "test_helper"

class DemoTest < Sauce::RailsTestCase
  test "my app", do
    page.open "/"
    page.is_text_present("Welcome Aboard").should be_true
  end
end

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

rake test:selenium:sauce

RSpec integration without Rails

First, configure with your account info:

sauce config USERNAME ACCESS_KEY

And here's an example test:

#!/usr/bin/env ruby
#
# Sample RSpec test case using the Sauce gem
#
require "rubygems"
require "sauce"

# This should go in your spec_helper.rb file if you have one
Sauce.config do |config|
  config.browser_url = "http://saucelabs.com/"
  config.browsers = [
    ["Linux", "firefox", "3.6."]
  ]

  # uncomment this if your server is not publicly accessible
  #config.application_host = "localhost"
  #config.application_port = "80"
end

# If this goes in spec/selenium/foo_spec.rb, you can omit the :type parameter
describe "The Sauce Labs website", :type => :selenium do
  it "should have a home page" do
    page.open "/"
    page.is_text_present("Sauce Labs").should be_true
  end

  it "should have a pricing page" do
    page.open "/"
    page.click "link=Pricing"
    page.wait_for_page_to_load 30000
    page.is_text_present("Free Trial").should be_true
  end
end

Test::Unit integration without Rails

First, configure with your account info:

sauce config USERNAME ACCESS_KEY

And here's an example test:

#!/usr/bin/env ruby
#
# Sample Test:Unit test case using the Sauce gem
#
require "test/unit"
require "rubygems"
require "sauce"

# This should go in your test_helper.rb file if you have one
Sauce.config do |config|
  config.browser_url = "http://saucelabs.com/"
  config.browsers = [
    ["Linux", "firefox", "3.6."]
  ]

  # uncomment this if your server is not publicly accessible
  #config.application_host = "localhost"
  #config.application_port = "80"
end

class ExampleTest < Sauce::TestCase
    def test_sauce
        page.open "/"
        assert page.title.include?("Sauce Labs")
    end
end

Direct use of the Selenium Client driver

First, configure with your account info:

sauce config USERNAME ACCESS_KEY

And here's an example test:

require 'rubygems'
require 'sauce'
selenium = Sauce::Selenium.new(:browser_url => "http://saucelabs.com",
    :browser => "firefox", :browser_version => "3.", :os => "Windows 2003",
    :job_name => "My first test!")
selenium.start
selenium.open "/"
selenium.stop

Note on Patches/Pull Requests

Testing the Gem

The tests in test/ need a bit of setup to get running:

if you're on Ubuntu:

For all platforms:

If you want tests to go a bit faster, globally install the gems with native extensions:

Copyright

Copyright (c) 2009-2011 Sauce Labs Inc. See LICENSE for details.