testingbot 0.0.9 → 0.1.0

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+before_script: echo "travis:rocks" > ~/.testingbot
+script: bundle exec rspec -P "spec/unit/*.rb"

data/Gemfile

@@ -1,4 +1,6 @@
 source "http://rubygems.org"
-
+gem 'rspec'
+gem 'cucumber'
+gem 'capybara'
 # Specify your gem's dependencies in testingbot.gemspec
 gemspec

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2011 TestingBot
+Copyright (c) 2012 TestingBot
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.rdoc

@@ -1,3 +1,5 @@
+{<img src="https://secure.travis-ci.org/testingbot/testingbot_ruby.png" />}[http://travis-ci.org/testingbot/testingbot_ruby]
+
 = TestingBot
 
 Testingbot.com is a website where you can use our cloud based Selenium grid. Test your web applications in various environments/browsers/devices.
@@ -11,7 +13,7 @@ You can install our testingbot ruby-gem by running "gem install testingbot" on y
 == Setup
 
 After you installed the gem you need to run a one part setup.
-Type testingbot in your commandline and fill in the API key and API secret you obtained on http://www.testingbot.com
+Type testingbot in your commandline and fill in the API key and API secret you obtained on http://testingbot.com
   $ testingbot
 
 == Usage
@@ -26,17 +28,11 @@ You can find an example in our examples folder, try something like this:
   	
   	def setup
   		@browser = Selenium::Client::Driver.new \
-  		:host => "hub.testingbot.com",
-  		:port => 4444,
   		:browser => "firefox",
   		:url => "http://www.google.com",
   		:platform => "WINDOWS",
   		:version => 10,
   		:timeout_in_second => 90
-  		
-  		browser.options = {
-  			:screenshot     => true
-  		}
 
   		browser.start_new_browser_session
   	end
@@ -58,18 +54,22 @@ This example uses RSpec 2. You can run it with rspec test_rspec.rb
   require "selenium/client"
   require 'rspec'
   require 'testingbot'
+  require 'testingbot/tunnel'
 
-  describe "Test", :type => :selenium do
+  # rspec 2
+  describe "People", :type => :selenium do
     attr_reader :selenium_driver
     before(:all) do
-        @selenium_driver = Selenium::Client::Driver.new \
-            :host => "hub.testingbot.com",
-            :port => 4444, 
-            :browser => "firefox", 
-            :url => "http://www.google.com", 
-            :timeout_in_second => 90,
-            :platform => "WINDOWS",
-            :version => "10"
+      # uncomment if you want to use our Tunnel
+      # tunnel = TestingBot::Tunnel.new
+      # tunnel.start
+
+      @selenium_driver = Selenium::Client::Driver.new \
+          :browser => "firefox", 
+          :url => "http://www.google.com", 
+          :timeout_in_second => 60,
+          :platform => "WINDOWS",
+          :version => "10"
     end
   
     before(:each) do
@@ -101,10 +101,8 @@ This example uses RSpec 1. You can run it with spec test_rspec1.rb
     attr_reader :selenium_driver
     alias :page :selenium_driver
     
-    before(:all) do
+      before(:all) do
           @selenium_driver = Selenium::Client::Driver.new \
-              :host => "hub.testingbot.com",
-              :port => 4444, 
               :browser => "firefox", 
               :url => "http://www.google.com", 
               :timeout_in_second => 90,
@@ -113,7 +111,7 @@ This example uses RSpec 1. You can run it with spec test_rspec1.rb
       end
 
       before(:each) do
-        selenium_driver.start_new_browser_session
+        @selenium_driver.start_new_browser_session
       end
 
       append_after(:each) do 
@@ -131,29 +129,18 @@ This example uses RSpec 2 together with capybara and Selenium webdriver. You can
 
   require 'rspec'
   require 'capybara/rspec'
-  require 'selenium/webdriver'
   require 'testingbot'
+  require 'testingbot/capybara'
 
-  RSpec.configure do |config|
-    caps = Selenium::WebDriver::Remote::Capabilities.firefox  
-    caps.version = "8"  
-    caps.platform = :WINDOWS 
-
-    Capybara.default_driver = :testingbot
-    Capybara.register_driver :testingbot do |app|
-      client = Selenium::WebDriver::Remote::Http::Default.new
-        client.timeout = 120
-        Capybara::Selenium::Driver.new(app,
-          :browser => :remote,
-          :url => "http://key:secret@hub.testingbot.com:4444/wd/hub",
-          :http_client => client,
-          :desired_capabilities => caps)
-    end
+  TestingBot::config do |config|
+    config[:desired_capabilities] = { :browserName => "firefox", :version => 9, :platform => "WINDOWS" }
+    # config.require_tunnel # uncomment if you want to use our Tunnel
   end
 
-  describe "Test", :type => :request do
+  describe "People", :type => :request do
     before :all do
-        Capybara.app_host = "http://testingbot.com"
+      Capybara.current_driver = :testingbot
+      Capybara.app_host = "http://testingbot.com"
     end
 
     it 'has a homepage with the word Selenium' do
@@ -162,15 +149,75 @@ This example uses RSpec 2 together with capybara and Selenium webdriver. You can
     end
   end
 
+=== Example RSpec 2, Capybara and Rails
+In this example we will need rspec-rails and Capybara, a rack server will be started by Capybara to run your localhost tests.
+Add the example below in spec/integration/home_spec.rb
+  ----------------------------------------------------------
+  spec_helper.rb:
+
+  require 'capybara/rspec'
+  require 'capybara/rails'
+  require 'testingbot'
+  require 'testingbot/capybara'
+
+  ----------------------------------------------------------
+  spec/integration/home_spec.rb:
+
+  require 'spec_helper'
+
+  TestingBot::config do |config|
+    config[:desired_capabilities] = { :browserName => "firefox", :version => 9, :platform => "WINDOWS", :localhost => "YES" }
+    config.require_tunnel
+  end
+
+  describe 'home page' do
+    before :all do
+      Capybara.server_port = 3011
+      Capybara.current_driver = :testingbot
+      Capybara.app_host = "http://127.0.0.1:3011"
+    end
+
+    it "shows the home page", :type => :request do
+      visit '/'
+      page.should have_content('Selenium')
+    end
+  end
+
+=== Example RSpec 2 run on multiple browsers
+Use the :multibrowser => true statement to indicate you want to test on multiple browsers.
+
+  require 'rubygems'
+  require "selenium/client"
+  require 'rspec'
+  require 'testingbot'
+  require 'testingbot/tunnel'
+
+  TestingBot::config do |config|
+    config[:desired_capabilities] = [{ :browserName => "firefox", :version => 9, :platform => "WINDOWS" }, { :browserName => "firefox", :version => 11, :platform => "WINDOWS" }]
+  end
+
+  describe "Google", :type => :selenium, :multibrowser => true do
+      it "can find the right title" do    
+        page.navigate.to "http://www.google.com"
+        page.title.should eql("Google")   
+      end
+  end
+
 == Capybara and Cucumber
-The examples directory contains an example of testing with Capybara and Cucumber
+The examples directory contains an example of testing with Capybara and Cucumber.
+The Rakefile in examples/cucumber contains a cucumber task which will run the same Cucumber story on multiple browsers.
+
 More info available on http://testingbot.com/support/getting-started/cucumber.html
 
+== Test this gem
+The tests for this gem are located in the spec folder, you can run them with this Rake task: 
+  rake spec
+
 == Extra options
-You can specify extra options like enabling/disabling the screenrecording or screenshot feature. (browser.options)
+You can specify extra options like enabling/disabling the screenrecording or screenshot feature.
+For WebDriver use the config[:desired_capabilities] to specify extra options.
 
-There's also an option to pass along extra data with your test, which will be visible on testingbot.com.
-For example a build number, or other custom data. (browser.extra = "")
+For RC tests use the start_new_browser_session(options) options hash.
 
 == More information
 

data/Rakefile

@@ -1 +1,16 @@
 require "bundler/gem_tasks"
+require 'rake'
+require 'rake/testtask'
+
+task :spec do
+  begin
+    require 'rspec/core/rake_task'
+    desc "Run the specs under spec/"
+    RSpec::Core::RakeTask.new do |t|
+    	t.fail_on_error = false
+	    t.pattern = FileList['spec/**/*_spec.rb'].exclude(/tunnel/)
+    end
+  rescue NameError, LoadError => e
+    puts e
+  end
+end

data/examples/android.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+require "rubygems"
+require File.expand_path(File.dirname(__FILE__) + '/../lib/testingbot/config.rb')
+require File.expand_path(File.dirname(__FILE__) + '/../lib/testingbot/selenium.rb')
+
+TestingBot::config do |config|
+	config[:desired_capabilities] = Selenium::WebDriver::Remote::Capabilities.android
+end
+
+driver = TestingBot::SeleniumWebdriver.new
+
+driver.navigate.to "http://testingbot.com/"
+puts driver.title
+driver.quit

data/examples/capybara.rb

@@ -1,32 +1,22 @@
 require 'rspec'
 require 'capybara/rspec'
-require 'selenium/webdriver'
 require 'testingbot'
+require 'testingbot/capybara'
 
-RSpec.configure do |config|
-	caps = Selenium::WebDriver::Remote::Capabilities.firefox  
-	caps.version = "8"  
-	caps.platform = :WINDOWS 
-
-	Capybara.default_driver = :testingbot
-	Capybara.register_driver :testingbot do |app|
-		client = Selenium::WebDriver::Remote::Http::Default.new
-  		client.timeout = 120
-	  	Capybara::Selenium::Driver.new(app,
-		    :browser => :remote,
-		    :url => "http://key:secret@hub.testingbot.com:4444/wd/hub",
-		    :http_client => client,
-		    :desired_capabilities => caps)
-	end
+TestingBot::config do |config|
+	config[:desired_capabilities] = { :browserName => "firefox", :version => 9, :platform => "WINDOWS" }
+	config[:options] = { :screenshot => false, :extra => "Some extra data" }
+	#config.require_tunnel
 end
 
 describe "People", :type => :request do
 	before :all do
+		Capybara.current_driver = :testingbot
 	    Capybara.app_host = "http://testingbot.com"
  	end
 
-  it 'has a homepage with the word Selenium' do
-    visit '/'
-    page.should have_content('Selenium')
-  end
+	it 'has a homepage with the word Selenium' do
+		visit '/'
+		page.should have_content('Selenium')
+	end
 end

data/examples/capybara_multiple_browsers.rb

@@ -0,0 +1,38 @@
+require 'rspec'
+require 'capybara/rspec'
+require 'testingbot'
+require 'testingbot/capybara'
+
+browsers = [{ :browserName => "firefox", :version => 9, :platform => "WINDOWS" }, { :browserName => "firefox", :version => 10, :platform => "WINDOWS" }]
+
+browsers.each do |browser|
+
+	shared_examples "an example test on #{browser[:browserName]} #{browser[:version]}" do |actions|
+	  	describe "Demo", :type => :request do
+			before :all do
+				TestingBot::config do |config|
+					config[:desired_capabilities] = browser
+				end
+				Capybara.run_server = false 
+				Capybara.current_driver = :testingbot
+			    Capybara.app_host = "http://testingbot.com"
+		 	end
+
+		 	after :all do
+		 		TestingBot.reset_config!
+		 		Capybara.current_driver = :testingbot
+		 		page.driver.browser.quit
+    			page.driver.instance_variable_set(:@browser, nil)
+		 	end
+
+			it 'has a homepage with the word Selenium' do
+				visit '/'
+				page.should have_content('Selenium')
+			end
+		end
+	end
+
+	describe "Sample", :type => :request do
+		it_behaves_like "an example test on #{browser[:browserName]} #{browser[:version]}"
+	end
+end

data/examples/cucumber/README.rdoc

@@ -0,0 +1,15 @@
+Testing with Cucumber, Selenium and Capybara
+
+== Usage
+
+This example contains a basic Cucumber story which will run on TestingBot.
+Included you will find a Rakefile which contains a cucumber task.
+If you run this Rake task you can run the same Cucumber story on multiple browsers.
+
+  rake cucumber
+
+You can specify the browser list inside the Rakefile.
+
+=== More information
+
+More info at http://testingbot.com/support/getting-started/ruby.html

data/examples/cucumber/Rakefile

@@ -0,0 +1,20 @@
+require "rubygems"
+require 'rake'
+require 'rake/testtask'
+require 'cucumber/rake/task'
+require 'selenium/rake/tasks'
+
+task :cucumber do
+  browsers = [{ :browserName => "firefox", :version => 9, :platform => "WINDOWS" }, { :browserName => "firefox", :version => 10, :platform => "WINDOWS" }]
+
+  browsers.each do |browser|
+    ENV['SELENIUM_BROWSERNAME'] = browser[:browserName]
+    ENV['SELENIUM_BROWSERVERSION'] = browser[:version].to_s
+    ENV['SELENIUM_BROWSERPLATFORM'] = browser[:platform]
+    Rake::Task[:run_cucumber].execute(browser)
+  end
+end
+
+Cucumber::Rake::Task.new(:run_cucumber) do |t|
+  t.cucumber_opts = ["features"]
+end

data/examples/cucumber/features/support/env.rb

@@ -4,35 +4,10 @@ require 'rspec'
 require 'selenium/webdriver'
 require 'testingbot/cucumber'
 
-if ENV['TESTINGBOT_BROWSER']
-	caps = {}
-	caps[:browser] = ENV['TESTINGBOT_BROWSER']
-	caps[:version] = ENV['TESTINGBOT_BROWSERVERSION'] || ""
-	caps[:platform] = ENV['TESTINGBOT_BROWSEROS'] || :WINDOWS 
-
-	Capybara.default_driver = :testingbot
-	Capybara.register_driver :testingbot do |app|
-		client = Selenium::WebDriver::Remote::Http::Default.new
-			client.timeout = 120
-	  	Capybara::Selenium::Driver.new(app,
-		    :browser => :remote,
-		    :url => "http://251ca561ab0f7557bb34c3ee3dbde285:3fc22e44f086fa036d8b01eadf66740b@hub.testingbot.com:4444/wd/hub",
-		    :http_client => client,
-		    :desired_capabilities => caps)
-	end
-else
-	caps = Selenium::WebDriver::Remote::Capabilities.firefox
-	caps.version = "10"  
-	caps.platform = :WINDOWS 
-
-	Capybara.default_driver = :testingbot
-	Capybara.register_driver :testingbot do |app|
-		client = Selenium::WebDriver::Remote::Http::Default.new
-			client.timeout = 120
-	  	Capybara::Selenium::Driver.new(app,
-		    :browser => :remote,
-		    :url => "http://251ca561ab0f7557bb34c3ee3dbde285:3fc22e44f086fa036d8b01eadf66740b@hub.testingbot.com:4444/wd/hub",
-		    :http_client => client,
-		    :desired_capabilities => caps)
+unless ENV['SELENIUM_BROWSERNAME'].nil?
+	TestingBot::config do |config|
+		config[:desired_capabilities] = { :browserName => ENV['SELENIUM_BROWSERNAME'], :version => ENV['SELENIUM_BROWSERVERSION'], :platform => ENV['SELENIUM_BROWSERPLATFORM'] }
 	end
 end
+
+Capybara.default_driver = :testingbot

data/examples/cucumber/features/youtube.feature

@@ -1,3 +1,4 @@
+@selenium
 Feature: YouTube has a search function.
 
 Background:

data/examples/test_rspec.rb

@@ -2,38 +2,16 @@ require 'rubygems'
 require "selenium/client"
 require 'rspec'
 require 'testingbot'
-#require 'testingbot/tunnel'
+require 'testingbot/tunnel'
 
-# rspec 2
-describe "People", :type => :selenium do
-  attr_reader :selenium_driver
-    before(:all) do
-        #TestingBot::Tunnel.start_tunnel("selenium@tunnel.testingbot.com", 2052)
+TestingBot::config do |config|
+  config[:desired_capabilities] = [{ :browserName => "firefox", :version => 9, :platform => "WINDOWS" }, { :browserName => "firefox", :version => 11, :platform => "WINDOWS" }]
+end
 
-        @selenium_driver = Selenium::Client::Driver.new \
-            :host => "hub.testingbot.com",
-            :port => 4444, 
-            :browser => "firefox", 
-            :url => "http://www.google.com", 
-            :timeout_in_second => 60,
-            :platform => "WINDOWS",
-            :version => "10"
-    end
-  
-    before(:each) do
-      @selenium_driver.start_new_browser_session
-    end
-  
-    after(:each) do
-      @selenium_driver.close_current_browser_session
-    end
-      
+# rspec 2
+describe "People", :type => :selenium, :multibrowser => true do
     it "can find the right title" do    
-      @selenium_driver.open "/"
-      @selenium_driver.title.should eql("Google")   
+      page.navigate.to "http://www.google.com"
+      page.title.should eql("Google")   
     end
-
-    # after(:all) do
-    #   TestingBot::Tunnel.stop_tunnel
-    # end
 end