testcentricity_web 4.2.6 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bba95ce17cd2e367f22261389fbe57cf7599ad7c8b376d293713929363dc7b2
-  data.tar.gz: e0e50d77d9e41d22652d6345820ef4258c31ff8e0ec63171fcfd6bba4bf8da17
+  metadata.gz: e1f34273e6126cc792065a37bdb761e8ca0f0c597e9030b3f9f58f2846a8d5c2
+  data.tar.gz: 43a3dbfb5c94a0ff10b161e01d4087c3973ed11b61596363b455e1f82897c403
 SHA512:
-  metadata.gz: ab4055f869598ce042c6b62172b8a89e9632268593dfcfec4cf4c7b401cfd66c3dfbfdd177f046aa429f80f575dd88558be187447cfcecd7ab2a32fa355cff78
-  data.tar.gz: 3c0581ac5599a71203eeb592f919de7a539ebb0855a2e3dd72cf9de2ae9a4ca69ecb7bf7b408a1540a432c1358337803ddc84eaf8d1827d6033904aa35f9e542
+  metadata.gz: 12b80dbd95dc924ca9b51b0ac5d7876f55642e8824b5f38e0fd19f008487a23f3a4d24418712785d93e93d1f330fbeaa03e7754c2fc8a3a9967d931cf47aab0b
+  data.tar.gz: a1bdb14f26c27829e71f0fb96c2ccb7183e5058dca09e46b0a515595611680ca6692f6c1a52f3c38cf60ba59c04f3ce720b29f8cd50be507a40119a13298d308

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.3.0] - 01-AUGUST-2022
+
+### Added
+* The `DRIVER` Environment Variable is now used to specify the `appium`, `browserstack`, `saucelabs`, `testingbot`,
+  or `lambdatest` driver.
+
+* ### Changed
+* The `WEB_BROWSER` Environment Variable is no longer used to specify the `appium`, `browserstack`, `saucelabs`, `testingbot`,
+or `lambdatest` driver.
+* TestCentricity now supports and integrates with Selenium-Webdriver version 4.3.
+
+
 ## [4.2.6] - 12-JUNE-2022
 
 ### Fixed

data/README.md

@@ -5,7 +5,7 @@
 
 
 The TestCentricity™ Web core framework for desktop and mobile web browser-based app testing implements a Page Object Model DSL for use
-with Cucumber (version 7.x or greater), Capybara (version 3.x), and Selenium-Webdriver (version 4.x). It also facilitates the configuration of the appropriate
+with Cucumber (version 7.x or greater), Capybara (version 3.37), and Selenium-Webdriver (version 4.3). It also facilitates the configuration of the appropriate
 Selenium-Webdriver capabilities required to establish a connection with a local or cloud hosted desktop or mobile web browser.
 
 The TestCentricity™ Web gem supports running automated tests against the following web test targets:
@@ -1383,7 +1383,7 @@ Once your test environment is properly configured, the following **Environment V
 
 | **Environment Variable**   | **Description**                                                                                                                                                       |
 |----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`              | Must be set to `appium`                                                                                                                                               |
+| `DRIVER`                   | Must be set to `appium`                                                                                                                                               |
 | `APP_PLATFORM_NAME`        | Must be set to `iOS`                                                                                                                                                  |
 | `APP_BROWSER`              | Must be set to `Safari`                                                                                                                                               |
 | `APP_VERSION`              | Must be set to `15.4`, `14.5`, or which ever iOS version you wish to run within the XCode Simulator                                                                   |
@@ -1426,7 +1426,7 @@ Once your test environment is properly configured, the following **Environment V
 
 | **Environment Variable**  | **Description**                                                                                                                |
 |---------------------------|--------------------------------------------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`             | Must be set to `appium`                                                                                                        |
+| `DRIVER`                  | Must be set to `appium`                                                                                                        |
 | `APP_PLATFORM_NAME`       | Must be set to `Android`                                                                                                       |
 | `APP_BROWSER`             | Must be set to `Chrome` or `Browser`                                                                                           |
 | `APP_VERSION`             | Must be set to `12.0`, or which ever Android OS version you wish to run with the Android Virtual Device                        |
@@ -1499,7 +1499,7 @@ for information regarding the specific capabilities.
 
 | **Environment Variable** | **Description**                                                                                                                                                            |
 |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`            | Must be set to `browserstack`                                                                                                                                              |
+| `DRIVER`                 | Must be set to `browserstack`                                                                                                                                              |
 | `BS_USERNAME`            | Must be set to your BrowserStack account user name                                                                                                                         |
 | `BS_AUTHKEY`             | Must be set to your BrowserStack account access key                                                                                                                        |
 | `BS_OS`                  | Must be set to `OS X` or `Windows`                                                                                                                                         |
@@ -1533,7 +1533,7 @@ for information regarding the specific capabilities.
 
 | **Environment Variable** | **Description**                                                                                                                                                            |
 |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`            | Must be set to `browserstack`                                                                                                                                              |
+| `DRIVER`                 | Must be set to `browserstack`                                                                                                                                              |
 | `BS_USERNAME`            | Must be set to your BrowserStack account user name                                                                                                                         |
 | `BS_AUTHKEY`             | Must be set to your BrowserStack account access key                                                                                                                        |
 | `BS_OS`                  | Must be set to `ios` or `android`                                                                                                                                          |
@@ -1559,7 +1559,7 @@ to obtain information regarding the specific capabilities.
 
 | **Environment Variable** | **Description**                                                                                                            |
 |--------------------------|----------------------------------------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`            | Must be set to `saucelabs`                                                                                                 |
+| `DRIVER`                 | Must be set to `saucelabs`                                                                                                 |
 | `SL_USERNAME`            | Must be set to your Sauce Labs account user name or email address                                                          |
 | `SL_AUTHKEY`             | Must be set to your Sauce Labs account access key                                                                          |
 | `DATA_CENTER`            | Must be set to your Sauce Labs account Data Center assignment (`us-west-1`, `eu-central-1`, `apac-southeast-1`)            |
@@ -1579,7 +1579,7 @@ regarding the specific capabilities.
 
 | **Environment Variable** | **Description**                                                                                                   |
 |--------------------------|-------------------------------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`            | Must be set to `testingbot`                                                                                       |
+| `DRIVER`                 | 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                                                                           |
@@ -1598,7 +1598,7 @@ to obtain information regarding the specific capabilities.
 
 | **Environment Variable** | **Description**                                                                          |
 |--------------------------|------------------------------------------------------------------------------------------|
-| `WEB_BROWSER`            | Must be set to `lambdatest`                                                              |
+| `DRIVER`                 | Must be set to `lambdatest`                                                              |
 | `LT_USERNAME`            | Must be set to your LambdaTest account user name or email address                        |
 | `LT_AUTHKEY`             | Must be set to your LambdaTest account access key                                        |
 | `LT_OS`                  | Refer to `platformName` capability in the sample script of the Wizard                    |
@@ -1724,7 +1724,7 @@ that you intend to connect with.
     # NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
     #==============
 
-    appium_ios: WEB_BROWSER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false
+    appium_ios: DRIVER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false
     app_ios_15: --profile appium_ios APP_VERSION="15.4"
     ipad_pro_12_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)"
     ipad_air_15_sim:    --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Air (5th generation)" <%= desktop %>
@@ -1745,7 +1745,7 @@ that you intend to connect with.
     # NOTE: Requires installation of Android Studio, Android version specific virtual device simulators, Appium, and the appium_capybara gem
     #==============
 
-    appium_android:    WEB_BROWSER=appium APP_PLATFORM_NAME="Android" <%= mobile %>
+    appium_android:    DRIVER=appium APP_PLATFORM_NAME="Android" <%= mobile %>
     app_android_12:    --profile appium_android APP_BROWSER="Chrome" APP_VERSION="12.0"
     pixel_c_api31_sim: --profile app_android_12 DEVICE_TYPE=tablet APP_DEVICE="Pixel_C_API_31"
 
@@ -1756,7 +1756,7 @@ that you intend to connect with.
     #          to your version control system
     #==============
     
-    browserstack: WEB_BROWSER=browserstack BS_USERNAME="<INSERT USER NAME HERE>" BS_AUTHKEY="<INSERT PASSWORD HERE>"
+    browserstack: DRIVER=browserstack BS_USERNAME="<INSERT USER NAME HERE>" BS_AUTHKEY="<INSERT PASSWORD HERE>"
     bs_desktop:   --profile browserstack <%= desktop %> RESOLUTION="1920x1080"
     bs_mobile:    --profile browserstack <%= mobile %>
     
@@ -1788,7 +1788,7 @@ that you intend to connect with.
     #          to your version control system
     #==============
     
-    saucelabs:  WEB_BROWSER=saucelabs SL_USERNAME="<INSERT USER NAME HERE>" SL_AUTHKEY="<INSERT PASSWORD HERE>" DATA_CENTER="<INSERT DATA CENTER HERE"
+    saucelabs:  DRIVER=saucelabs SL_USERNAME="<INSERT USER NAME HERE>" SL_AUTHKEY="<INSERT PASSWORD HERE>" DATA_CENTER="<INSERT DATA CENTER HERE"
     sl_desktop: --profile saucelabs <%= desktop %>
     sl_mobile:  --profile saucelabs <%= mobile %>
     
@@ -1814,7 +1814,7 @@ that you intend to connect with.
     #          to your version control system
     #==============
     
-    testingbot: WEB_BROWSER=testingbot TB_USERNAME="<INSERT USER NAME HERE>" TB_AUTHKEY="<INSERT PASSWORD HERE>"
+    testingbot: DRIVER=testingbot TB_USERNAME="<INSERT USER NAME HERE>" TB_AUTHKEY="<INSERT PASSWORD HERE>"
     tb_desktop: --profile testingbot <%= desktop %> RESOLUTION="1920x1200"
     
     # TestingBot macOS desktop browser profiles
@@ -1835,7 +1835,7 @@ that you intend to connect with.
     #          to your version control system
     #==============
     
-    lambdatest: WEB_BROWSER=lambdatest LT_USERNAME=<INSERT USER NAME HERE> LT_AUTHKEY=<INSERT PASSWORD HERE>
+    lambdatest: DRIVER=lambdatest LT_USERNAME=<INSERT USER NAME HERE> LT_AUTHKEY=<INSERT PASSWORD HERE>
     lt_desktop: --profile lambdatest <%= desktop %> RESOLUTION="2560x1440"
     
     # LambdaTest macOS desktop browser profiles

data/lib/testcentricity_web/browser_helper.rb

@@ -173,7 +173,8 @@ module TestCentricity
           @devices = @devices.merge(ext_devices)
         end
       end
-      @devices[device.gsub(/\s+/, '').downcase.to_sym]
+      device = device.gsub(/\s+/, '').downcase.to_sym if device.is_a?(String)
+      @devices[device]
     end
   end
 end

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.2.6'
+  VERSION = '4.3.0'
 end

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -24,8 +24,13 @@ module TestCentricity
         @endpoint = options[:endpoint] if options.key?(:endpoint)
         @capabilities = options[:desired_capabilities] if options.key?(:desired_capabilities)
       end
-
-      browser = ENV['WEB_BROWSER']
+      # determine browser type and driver
+      Environ.browser = ENV['WEB_BROWSER'] if ENV['WEB_BROWSER']
+      Environ.driver = if ENV['DRIVER']
+                         ENV['DRIVER'].downcase.to_sym
+                       else
+                         :webdriver
+                       end
       # set downloads folder path
       @downloads_path = "#{Dir.pwd}/downloads"
       if ENV['PARALLEL']
@@ -43,18 +48,16 @@ module TestCentricity
       @downloads_path = @downloads_path.tr('/', "\\") if OS.windows?
 
       # assume that we're testing within a local desktop web browser
-      Environ.driver      = :webdriver
       Environ.platform    = :desktop
-      Environ.browser     = browser
       Environ.headless    = false
       Environ.device      = :web
       Environ.device_name = 'browser'
 
-      context = case browser.downcase.to_sym
+      context = case Environ.driver
                 when :appium
                   initialize_appium
                   'Appium'
-                # :nocov:
+                  # :nocov:
                 when :browserstack
                   initialize_browserstack
                   'Browserstack cloud service'
@@ -67,8 +70,7 @@ module TestCentricity
                 when :testingbot
                   initialize_testingbot
                   'TestingBot cloud service'
-                # :nocov:
-                else
+                when :webdriver
                   if ENV['SELENIUM'] == 'remote'
                     initialize_remote
                     'Selenium Grid'
@@ -142,6 +144,7 @@ module TestCentricity
     def self.initialize_appium
       Environ.platform = :mobile
       Environ.device = :simulator
+      Environ.browser = ENV['APP_BROWSER']
       Environ.device_name = ENV['APP_DEVICE']
       Environ.device_os = ENV['APP_PLATFORM_NAME'].downcase.to_sym
       Environ.device_type = ENV['DEVICE_TYPE'] if ENV['DEVICE_TYPE']
@@ -154,7 +157,7 @@ module TestCentricity
                                desired_capabilities = {
                                  platformName: Environ.device_os,
                                  platformVersion: Environ.device_os_version,
-                                 browserName: ENV['APP_BROWSER'],
+                                 browserName: Environ.browser,
                                  deviceName: Environ.device_name
                                }
                                desired_capabilities[:avd] = ENV['APP_DEVICE'] if Environ.device_os == :android
@@ -231,7 +234,7 @@ module TestCentricity
                    else
                      'unknown'
                    end
-      browser = ENV['WEB_BROWSER'].downcase.to_sym
+      browser = Environ.browser.downcase.to_sym
 
       case browser
       when :firefox, :chrome, :ie, :safari, :edge
@@ -241,7 +244,7 @@ module TestCentricity
         Environ.headless = true
       else
         Environ.platform = :mobile
-        Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
+        Environ.device_name = Browsers.mobile_device_name(Environ.browser)
       end
 
       Capybara.register_driver :selenium do |app|
@@ -259,8 +262,8 @@ module TestCentricity
           Capybara::Selenium::Driver.new(app, browser: :edge, capabilities: [options])
         else
           if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
-            user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
-            options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+            user_agent = Browsers.mobile_device_agent(Environ.browser)
+            options = Selenium::WebDriver::Chrome::Options.new
             options.add_argument('--disable-dev-shm-usage')
             options.add_argument("--user-agent='#{user_agent}'")
             options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
@@ -275,7 +278,7 @@ module TestCentricity
 
     def self.initialize_remote
       Environ.grid = :selenium_grid
-      browser  = ENV['WEB_BROWSER'].downcase.to_sym
+      browser  = Environ.browser.downcase.to_sym
       @endpoint = ENV['REMOTE_ENDPOINT'] || 'http://127.0.0.1:4444/wd/hub' if @endpoint.nil?
 
       case browser
@@ -290,9 +293,9 @@ module TestCentricity
       else
         if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
           Environ.platform = :mobile
-          Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
-          user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
-          options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+          Environ.device_name = Browsers.mobile_device_name(Environ.browser)
+          user_agent = Browsers.mobile_device_agent(Environ.browser)
+          options = Selenium::WebDriver::Chrome::Options.new
           options.add_argument('--disable-dev-shm-usage')
           options.add_argument("--user-agent='#{user_agent}'")
           options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
@@ -396,7 +399,7 @@ module TestCentricity
                   else
                     # define desktop browser options
                     bs_options[:resolution] = ENV['RESOLUTION'] if ENV['RESOLUTION']
-                    bs_options[:seleniumVersion] = '4.1.0'
+                    bs_options[:seleniumVersion] = '4.3.0'
                     {
                       browserName: browser,
                       browserVersion: ENV['BS_VERSION'],
@@ -578,9 +581,9 @@ module TestCentricity
     def self.chrome_edge_options(browser)
       options = case browser
                 when :chrome, :chrome_headless
-                  Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+                  Selenium::WebDriver::Chrome::Options.new
                 when :edge, :edge_headless
-                  Selenium::WebDriver::Edge::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+                  Selenium::WebDriver::Edge::Options.new
                 end
       prefs = {
         prompt_for_download: false,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.2.6
+  version: 4.3.0
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-12 00:00:00.000000000 Z
+date: 2022-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appium_capybara
@@ -42,16 +42,16 @@ dependencies:
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 8.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 8.0.0
 - !ruby/object:Gem::Dependency
   name: cuke_modeler
   requirement: !ruby/object:Gem::Requirement
@@ -140,16 +140,16 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: 3.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: 3.11.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -212,7 +212,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: 3.37.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '4'
@@ -222,7 +222,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: 3.37.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '4'
@@ -302,7 +302,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: 4.3.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '5'
@@ -312,7 +312,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: 4.3.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '5'