testcentricity_web 0.5.8 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 827f668182f61bf19480bb993ff1c452fd155982
-  data.tar.gz: 58564669674cf2fc3ddf62b1ffb5b5074a982b88
+  metadata.gz: 2fb8bf051e24256d81fbc0d4251558dcaa032115
+  data.tar.gz: 339e86a0105a98df17b3cb9e84e1b584ded85402
 SHA512:
-  metadata.gz: 11f086f65e4c2725c06957e42abff668674a2515a527f2d7876457adcd596ced605693430853aaff77fd658f9703a9b4d19e771987d49fcba025a2062d04e7e9
-  data.tar.gz: 73174e2dce406fbde1678af1d133c48e467ee93bcfd112be75a272582ec29bd79b0853b91e34e14cf78bc5a97fe104cbaea446c253debcdc1eceae3d89059ec5
+  metadata.gz: a2879ff733f7d7a9c0815ed99265c2b58f1651d53e1d29101573b26b5ae97376b5b666b754fecba7ac75f95ae631844252e48e61fb2d3d2c80c8ac5b3d0ef053
+  data.tar.gz: c2fbacd4e3819a92601b257a75aa80116f988518cfe8c4091d3fe974392679e8d8313dff748221a48aaa7400f3272cab2b58953c8e2647c82bfc44b8bf3aefb4

data/README.md

@@ -3,7 +3,7 @@
 The TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object and Data Object Model DSL for
 use with Cucumber, Capybara, and selenium-webdriver. It supports testing against locally hosted desktop browsers (Firefox, Chrome, Safari,
 IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox), a "headless" browser (using Poltergeist and PhantomJS),
-or on cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, or CrossBrowserTesting services.
+or on cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
  
  
 ## Installation
@@ -28,6 +28,7 @@ If you are using Cucumber, you need to require the following in your *env.rb* fi
 
     require 'capybara'
     require 'capybara/cucumber'
+    require 'selenium-webdriver'
     require 'testcentricity_web'
     
     
@@ -37,15 +38,16 @@ If you are using RSpec instead, you need to require the following in your *env.r
 
     require 'capybara'
     require 'capybara/rspec'
+    require 'selenium-webdriver'
     require 'testcentricity_web'
     
     
-###Selenium WebDriver
+### Using Poltergeist
 
-If you choose to not connect to selenium-webdriver using the ***WebDriverConnect.initialize_web_driver*** method, or if you need to directly
-call methods in selenium-webdriver, you will also need to require the following in your *env.rb* file:
+If you will be running your tests on a "headless" web browser using Poltergeist and PhantomJS, you must add this line to your automation
+project's Gemfile:
 
-    require 'selenium-webdriver'
+    gem 'poltergeist'
 
 
 
@@ -324,8 +326,8 @@ To specify the emulated device's screen orientation, you set the **ORIENTATION**
 
 ### Remotely hosted desktop and mobile web browsers
 
-You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting, or
-Sauce Labs services.
+You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting,
+Sauce Labs, or TestingBot services.
 
 
 #### Remote desktop browsers on the BrowserStack service
@@ -429,14 +431,31 @@ SL_DEVICE_TYPE | If displayed, refer to ***deviceType*** capability in the Copy
 ORIENTATION | Refer to ***deviceOrientation*** capability in the Copy Code section of the Platform Configurator page
 
 
+#### Remote desktop browsers on the TestingBot service
+
+For remotely hosted desktop web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
+the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information regarding the specific capabilities.
+
+**Environment Variable** | Description
+--------------- | ----------------
+WEB_BROWSER | Must be set to ***testingbot***
+TB_USERNAME | Must be set to your TestingBot account user name
+TB_AUTHKEY | Must be set to your TestingBot account access key
+TB_OS | Refer to ***platform*** capability in chart
+TB_BROWSER | Refer to ***browserName*** capability in chart
+TB_VERSION | Refer to ***version*** capability in chart
+RESOLUTION | Possible values: 800x600, 1024x768, 1280x960, 1280x1024, 1600x1200, 1920x1200, 2560x1440
+
 
 ### Using Browser specific Profiles in cucumber.yml
 
-While you can set **Environment Variables** in the command line when invoking Cucumber, a preferred method of specifying and managing target
-web browsers is to create browser specific **Profiles** that set the appropriate **Environment Variables** for each target browser in your
-***cucumber.yml*** file. Below is a list of Cucumber **Profiles** for supported locally and remotely hosted desktop and mobile web browsers
-(put these in in your ***cucumber.yml*** file). Before you can use the BrowserStack, CrossBrowserTesting, or Sauce Labs services, you will
-need to replace the placeholder text with your user account and authorization code for the cloud service(s) that you intend to connect with.
+While you can set **Environment Variables** in the command line when invoking Cucumber, a preferred method of specifying and managing
+target web browsers is to create browser specific **Profiles** that set the appropriate **Environment Variables** for each target browser
+in your ***cucumber.yml*** file. Below is a list of Cucumber **Profiles** for supported locally and remotely hosted desktop and mobile
+web browsers (put these in in your ***cucumber.yml*** file).
+
+Before you can use the BrowserStack, CrossBrowserTesting, Sauce Labs, or TestingBot services, you will need to replace the placeholder
+text with your user account and authorization code for the cloud service(s) that you intend to connect with.
 
     <% desktop          = "--tags ~@wip --tags ~@failing --tags @desktop --require features" %>
     <% mobile           = "--tags ~@wip --tags ~@failing --tags @mobile  --require features" %>
@@ -659,6 +678,52 @@ need to replace the placeholder text with your user account and authorization co
     sl_android:         --profile sl_mobile SL_PLATFORM=Linux SL_BROWSER="android" SL_VERSION="4.4"
     sl_android_phone:   --profile sl_android SL_DEVICE="Android Emulator" SL_DEVICE_TYPE="phone"
     sl_android_tablet:  --profile sl_android SL_DEVICE="Android Emulator" SL_DEVICE_TYPE="tablet"
+    
+    
+    #==============
+    # profiles for remotely hosted web browsers on the TestingBot service
+    #==============
+    
+    testingbot:         WEB_BROWSER=testingbot TB_USERNAME=<INSERT USER NAME HERE> TB_AUTHKEY=<INSERT PASSWORD HERE>
+    tb_desktop:         --profile testingbot <%= desktop %> RESOLUTION="1920x1200"
+    tb_mobile:          --profile testingbot <%= mobile %>
+    
+    # TestingBot OS X profiles
+    tb_osx_el_capitan:  --profile tb_desktop TB_OS="CAPITAN"
+    tb_ff_el_cap:       --profile tb_osx_el_capitan TB_BROWSER="firefox"
+    tb_chrome_el_cap:   --profile tb_osx_el_capitan TB_BROWSER="chrome"
+    tb_safari_el_cap:   --profile tb_osx_el_capitan TB_BROWSER="safari" TB_VERSION="9"
+    tb_safari9_el_cap:  --profile tb_osx_el_capitan TB_BROWSER="safari" TB_VERSION="9"
+    
+    tb_osx_yosemite:    --profile tb_desktop TB_OS="YOSEMITE"
+    tb_ff_yos:          --profile tb_osx_yosemite TB_BROWSER="firefox"
+    tb_chrome_yos:      --profile tb_osx_yosemite TB_BROWSER="chrome"
+    tb_safari_yos:      --profile tb_osx_yosemite TB_BROWSER="safari" TB_VERSION="8"
+    tb_safari8_osx:     --profile tb_osx_yosemite TB_BROWSER="safari" TB_VERSION="8"
+    
+    tb_osx_mavericks:   --profile tb_desktop TB_OS="MAVERICKS"
+    tb_ff_mav:          --profile tb_osx_mavericks TB_BROWSER="firefox"
+    tb_chrome_mav:      --profile tb_osx_mavericks TB_BROWSER="chrome"
+    tb_safari_mav:      --profile tb_osx_mavericks TB_BROWSER="safari" TB_VERSION="7"
+    tb_safari7_osx:     --profile tb_osx_mavericks TB_BROWSER="safari" TB_VERSION="7"
+    
+    # TestingBot Windows profiles
+    tb_win7:            --profile tb_desktop TB_OS="WIN7"
+    tb_win8:            --profile tb_desktop TB_OS="WIN8"
+    tb_win10:           --profile tb_desktop TB_OS="WIN10"
+    tb_ff_win7:         --profile tb_win7 TB_BROWSER="firefox"
+    tb_ff_win8:         --profile tb_win8 TB_BROWSER="firefox"
+    tb_ff_win10:        --profile tb_win10 TB_BROWSER="firefox"
+    tb_chrome_win7:     --profile tb_win7 TB_BROWSER="chrome"
+    tb_chrome_win8:     --profile tb_win8 TB_BROWSER="chrome"
+    tb_chrome_win10:    --profile tb_win10 TB_BROWSER="chrome"
+    
+    tb_ie9_win7:        --profile tb_win7 TB_BROWSER="internet explorer" TB_VERSION="9"
+    tb_ie11_win8:       --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="11"
+    tb_ie10_win8:       --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="10"
+    tb_ie11_win10:      --profile tb_win10 TB_BROWSER="internet explorer" TB_VERSION="11"
+    tb_edge_win10:      --profile tb_win10 TB_BROWSER="microsoftedge" TB_VERSION="13"
+
 
 To specify a locally hosted target browser using a profile at runtime, you use the flag --profile or -p followed by the profile name when
 invoking Cucumber in the command line. For instance, the following command invokes Cucumber and specifies that a local instance of Chrome
@@ -675,6 +740,11 @@ The following command specifies that Cucumber will run tests against a remotely
 virtual machine on the BrowserStack service:
 
     cucumber -p bs_safari_yos
+ 
+The following command specifies that Cucumber will run tests against a remotely hosted Mobile Safari web browser on an iPhone 6s Plus in
+landscape orientation running on the BrowserStack service:
+
+    cucumber -p bs_iphone6_plus -p landscape
 
 
 

data/lib/testcentricity_web/data_objects_helper.rb

@@ -22,17 +22,17 @@ module TestCentricity
     attr_accessor :current
 
     def pick_excel_data_source(sheet, row_name)
-      data_file = Excel_Data.get_environment_data_file
-      data_file = XL_PRIMARY_DATA_FILE unless Excel_Data.rowspec_exists?(data_file, sheet, row_name)
+      data_file = ExcelData.get_environment_data_file
+      data_file = XL_PRIMARY_DATA_FILE unless ExcelData.rowspec_exists?(data_file, sheet, row_name)
       data_file
     end
 
     def read_excel_row_data(sheet, row_name)
-      Excel_Data.read_row_data(pick_excel_data_source(sheet, row_name), sheet, row_name)
+      ExcelData.read_row_data(pick_excel_data_source(sheet, row_name), sheet, row_name)
     end
 
     def read_excel_pool_data(sheet, row_name)
-      Excel_Data.read_row_from_pool(pick_excel_data_source(sheet, row_name), sheet, row_name)
+      ExcelData.read_row_from_pool(pick_excel_data_source(sheet, row_name), sheet, row_name)
     end
   end
 end

data/lib/testcentricity_web/environment.rb

@@ -5,7 +5,7 @@ module TestCentricity
     WKS_ENVIRONS ||= 'Environments'
 
     def find_environ(row_name)
-      @current = Environ.new(Excel_Data.read_row_data(XL_PRIMARY_DATA_FILE, WKS_ENVIRONS, row_name))
+      @current = Environ.new(ExcelData.read_row_data(XL_PRIMARY_DATA_FILE, WKS_ENVIRONS, row_name))
       Environ.set_current(@current)
     end
   end

data/lib/testcentricity_web/excel_helper.rb

@@ -10,7 +10,7 @@ module TestCentricity
   XL_PRIMARY_DATA_FILE  ||= "#{XL_PRIMARY_DATA_PATH}data.xls"
 
 
-  class Excel_Data
+  class ExcelData
     @mru = {}
 
     def self.get_environment_data_file

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '0.5.8'
+  VERSION = '0.6.0'
 end

data/lib/testcentricity_web/webdriver_helper.rb

@@ -1,5 +1,8 @@
+require 'selenium-webdriver'
+
+
 module TestCentricity
-  module WebDriverConnect
+  class WebDriverConnect
     include Capybara::DSL
 
     def self.initialize_web_driver(app_host = nil)
@@ -16,10 +19,12 @@ module TestCentricity
           initialize_browserstack
         when :crossbrowser
           initialize_crossbrowser
-        when :saucelabs
-          initialize_saucelabs
         when :poltergeist
           initialize_poltergeist
+        when :saucelabs
+          initialize_saucelabs
+        when :testingbot
+          initialize_testingbot
         else
           initialize_local_browser(browser)
       end
@@ -58,20 +63,6 @@ module TestCentricity
       end
     end
 
-    def self.initialize_poltergeist
-      Capybara.default_driver = :poltergeist
-      Capybara.register_driver :poltergeist do |app|
-        options = {
-            :js_errors => true,
-            :timeout => 120,
-            :debug => false,
-            :phantomjs_options => ['--load-images=no', '--disk-cache=false'],
-            :inspector => true,
-        }
-        Capybara::Poltergeist::Driver.new(app, options)
-      end
-    end
-
     def self.initialize_browserstack
       browser = ENV['BS_BROWSER']
 
@@ -153,6 +144,20 @@ module TestCentricity
       Capybara.run_server = false
     end
 
+    def self.initialize_poltergeist
+      Capybara.default_driver = :poltergeist
+      Capybara.register_driver :poltergeist do |app|
+        options = {
+            :js_errors => true,
+            :timeout => 120,
+            :debug => false,
+            :phantomjs_options => ['--load-images=no', '--disk-cache=false'],
+            :inspector => true,
+        }
+        Capybara::Poltergeist::Driver.new(app, options)
+      end
+    end
+
     def self.initialize_saucelabs
       browser = ENV['SL_BROWSER']
 
@@ -183,5 +188,36 @@ module TestCentricity
       Capybara.default_driver = :saucelabs
       Capybara.run_server = false
     end
+
+    def self.initialize_testingbot
+      browser = ENV['TB_BROWSER']
+
+      endpoint = "http://#{ENV['TB_USERNAME']}:#{ENV['TB_AUTHKEY']}@hub.testingbot.com:4444/wd/hub"
+      Capybara.register_driver :testingbot do |app|
+        capabilities = Selenium::WebDriver::Remote::Capabilities.new
+        capabilities['name'] = ENV['AUTOMATE_PROJECT'] if ENV['AUTOMATE_PROJECT']
+        capabilities['build'] = ENV['AUTOMATE_BUILD'] if ENV['AUTOMATE_BUILD']
+        capabilities['browserName'] = browser
+        capabilities['version'] = ENV['TB_VERSION'] if ENV['TB_VERSION']
+        capabilities['screen-resolution'] = ENV['RESOLUTION'] if ENV['RESOLUTION']
+        if ENV['TB_OS']
+          capabilities['platform'] = ENV['TB_OS']
+          Environ.set_platform(:desktop)
+        elsif ENV['TB_PLATFORM']
+          capabilities['platform'] = ENV['TB_PLATFORM']
+          capabilities['browserName'] = ENV['TB_DEVICE']
+          capabilities['version'] = ENV['TB_VERSION'] if ENV['TB_VERSION']
+          Environ.set_platform(:mobile)
+        end
+
+        Capybara::Selenium::Driver.new(app, :browser => :remote, :url => endpoint, :desired_capabilities => capabilities)
+      end
+
+      Environ.set_browser(browser)
+
+      Capybara.default_driver = :testingbot
+      Capybara.run_server = false
+
+    end
   end
 end

data/testcentricity_web.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
     for use with Cucumber, Capybara, and selenium-webdriver. Supports testing against locally hosted desktop browsers
     (Firefox, Chrome, Safari, IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox), a
     "headless" browser (using Poltergeist and PhantomJS), or on cloud hosted browsers using the BrowserStack, Sauce Labs,
-    or CrossBrowserTesting services.}
+    CrossBrowserTesting, or TestingBot services.}
   spec.homepage      = ''
   spec.license       = 'BSD3'
 
@@ -30,8 +30,8 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'capybara', ['>= 2.1', '< 3.0']
   spec.add_dependency 'test-unit'
+  spec.add_dependency 'selenium-webdriver', ['>= 2.50.0', '< 2.53.0']
   spec.add_dependency 'poltergeist'
-  spec.add_dependency 'selenium-webdriver', '>= 2.50.0'
   spec.add_dependency 'faker', '>= 1.6.1'
   spec.add_dependency 'chronic', '>= 0.10.2'
   spec.add_dependency 'spreadsheet', '>= 1.1.1'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 0.5.8
+  version: 0.6.0
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-21 00:00:00.000000000 Z
+date: 2016-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -73,33 +73,39 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: poltergeist
+  name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.50.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.53.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.50.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.53.0
 - !ruby/object:Gem::Dependency
-  name: selenium-webdriver
+  name: poltergeist
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.50.0
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.50.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: faker
   requirement: !ruby/object:Gem::Requirement
@@ -148,7 +154,7 @@ description: |2-
       for use with Cucumber, Capybara, and selenium-webdriver. Supports testing against locally hosted desktop browsers
       (Firefox, Chrome, Safari, IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox), a
       "headless" browser (using Poltergeist and PhantomJS), or on cloud hosted browsers using the BrowserStack, Sauce Labs,
-      or CrossBrowserTesting services.
+      CrossBrowserTesting, or TestingBot services.
 email:
 - test_automation@icloud.com
 executables: []