testcentricity_web 3.2.22 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 492ee58605ae048033c9ec360becc477530171ffa45c97e57b36b6177fbaab57
-  data.tar.gz: 16e8b95789c909ba7f65e1bab13bc97a507ada6b74888716b5055cb0b1d654e7
+  metadata.gz: df556101ef2de8b85dae896e6d943d621e220a452101257a8c36aa4f32a6db51
+  data.tar.gz: 324e34cc74ccd75892e7cbba3f11ab6e4ada25699c94b8a5c9d49dda411866a7
 SHA512:
-  metadata.gz: cc2cbad5d7d8abac64d8fe18f16b90f23b00b7c18caa8178f16d618d3af8cbbc20af142e51391551a64e36a3dfb6540e1b27d5fd01d572aa1a395149e7cd13fe
-  data.tar.gz: 29bd80da7052736a7e5ddc916eff5eb1c91593267441d1a5fedbeed9ffdc84a5823d915b806f29299eddbaadfffc54a8fe0dc1b92d947cee47c76ad024b2aae5
+  metadata.gz: 88a64d973f5dc89fee73245eb888c41c3d8fc673b83548e11798f5d4bc80679176a2abe0a5cde655e8d5c67a1d1887fa9963ecef92eeb2521e8dc6367d8bc3e6
+  data.tar.gz: 2f7a3967eadac906420d7175a0d8c0d915b6f70240aaee0a333bf332f6ed5b08a376464af7a7cc6a472f46540000e7e607dd4ac99b000c3f81e53c43488956d7

data/CHANGELOG.md

@@ -1,6 +1,53 @@
 # CHANGELOG
 All notable changes to this project will be documented in this file.
 
+## [4.0.0] - 25-MAR-2021
+
+### Changed
+* `WebDriverConnect.initialize_web_driver` method now accepts an `options` hash as an optional parameter, which can be used to
+  specify an optional base host URL and/or the desired Selenium-Webdriver capabilities required to establish a connection with
+  a cloud hosted target web browser.
+* User defined mobile device profiles can be specified in a `device.yml` file for testing locally hosted emulated mobile
+  web browsers running in an instance of the Chrome desktop browser. The user specified device profiles must be located at 
+  `config/data/devices/devices.yml`. Refer to the **User defined mobile device profiles** section of the {file:README.md README} file.
+
+### Removed
+* Removed support for the following legacy UI elements:
+  * `CellElement`
+  * `CellButton`
+  * `CellCheckBox`
+  * `CellRadio`
+  * `CellImage`
+  * `ListElement`
+  * `ListButton`
+  * `ListCheckBox`
+* Removed support for Siebel Open UI objects. This includes removal of the following legacy methods:
+  * `CheckBox.set_siebel_checkbox_state`
+  * `SelectList.choose_siebel_option`
+  * `SelectList.get_siebel_options`
+  * `SelectList.verify_siebel_options`
+  * `SelectList.read_only?`
+  * `UIElement.invoke_siebel_dialog`
+  * `UIElement.invoke_siebel_popup`
+  * `UIElement.get_siebel_object_type`
+
+## [3.3.0] - 14-MAR-2021
+
+### Fixed
+* `WebDriverConnect.initialize_web_driver` method now correctly sets local Chrome browser Download directory when running
+with headless Chrome.
+
+## [3.2.25] - 11-MAR-2021
+
+### Added
+* Added `String.titlecase` method.
+
+## [3.2.23] - 11-FEB-2021
+
+### Changed
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to allow `:translate_upcase`,
+  `:translate_downcase`, `:translate_capitalize`, and `:translate_titlecase` conversions to fall back to `:en` default
+  locale if translated strings are missing from the current locale specified in `I18n.locale`.
 
 ## [3.2.22] - 09-FEB-2021
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (3.2.22)
+    testcentricity_web (4.0.0.a1)
       appium_lib
       browserstack-local
       capybara (>= 3.1, < 4)
@@ -21,58 +21,60 @@ GEM
   specs:
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
-    appium_lib (10.6.0)
-      appium_lib_core (~> 3.3)
+    appium_lib (11.2.0)
+      appium_lib_core (~> 4.1)
       nokogiri (~> 1.8, >= 1.8.1)
       tomlrb (~> 1.1)
-    appium_lib_core (3.10.0)
-      faye-websocket (~> 0.10.0)
+    appium_lib_core (4.5.0)
+      faye-websocket (~> 0.11.0)
       selenium-webdriver (~> 3.14, >= 3.14.1)
     axiom-types (0.1.1)
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
     browserstack-local (1.3.0)
-    capybara (3.32.2)
+    capybara (3.35.3)
       addressable
       mini_mime (>= 0.1.3)
       nokogiri (~> 1.8)
       rack (>= 1.6.0)
       rack-test (>= 0.6.3)
-      regexp_parser (~> 1.5)
+      regexp_parser (>= 1.5, < 3.0)
       xpath (~> 3.2)
     childprocess (0.9.0)
       ffi (~> 1.0, >= 1.0.11)
     chronic (0.10.2)
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
-    concurrent-ruby (1.1.6)
+    concurrent-ruby (1.1.8)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
     equalizer (0.0.11)
     eventmachine (1.2.7)
-    faker (2.12.0)
+    faker (2.17.0)
       i18n (>= 1.6, < 2)
-    faye-websocket (0.10.9)
+    faye-websocket (0.11.0)
       eventmachine (>= 0.12.0)
       websocket-driver (>= 0.5.1)
-    ffi (1.13.1)
-    i18n (1.8.3)
+    ffi (1.15.0)
+    i18n (1.8.10)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
-    mini_mime (1.0.2)
-    mini_portile2 (2.4.0)
-    nokogiri (1.10.9)
-      mini_portile2 (~> 2.4.0)
-    os (1.1.0)
-    power_assert (1.2.0)
-    public_suffix (4.0.5)
+    mini_mime (1.1.0)
+    mini_portile2 (2.5.0)
+    nokogiri (1.11.3)
+      mini_portile2 (~> 2.5.0)
+      racc (~> 1.4)
+    os (1.1.1)
+    power_assert (2.0.0)
+    public_suffix (4.0.6)
+    racc (1.5.2)
     rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
     rake (13.0.1)
     redcarpet (3.5.0)
-    regexp_parser (1.7.1)
+    regexp_parser (2.1.1)
     ruby-ole (1.2.12.2)
     rubyzip (2.3.0)
     selenium-webdriver (3.142.7)
@@ -80,7 +82,7 @@ GEM
       rubyzip (>= 1.2.2)
     spreadsheet (1.1.7)
       ruby-ole (>= 1.0)
-    test-unit (3.3.6)
+    test-unit (3.4.1)
       power_assert
     thread_safe (0.3.6)
     tomlrb (1.3.0)
@@ -89,11 +91,11 @@ GEM
       coercible (~> 1.0)
       descendants_tracker (~> 0.0, >= 0.0.3)
       equalizer (~> 0.0, >= 0.0.9)
-    webdrivers (4.4.1)
+    webdrivers (4.6.0)
       nokogiri (~> 1.6)
       rubyzip (>= 1.3.0)
       selenium-webdriver (>= 3.0, < 4.0)
-    websocket-driver (0.7.2)
+    websocket-driver (0.7.3)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
     xpath (3.2.0)

data/README.md

@@ -23,7 +23,6 @@ The TestCentricity™ Web gem supports running automated tests against the follo
   * [Gridlastic](https://www.gridlastic.com/test-environments.html)
   * [LambdaTest](https://www.lambdatest.com/selenium-automation)
 * web portals utilizing JavaScript front end application frameworks like Ember, React, Angular, and GWT
-* enterprise web portals built using Siebel Open UI
 * web pages containing HTML5 Video and Audio objects
 
 
@@ -483,6 +482,7 @@ With TestCentricity, all UI elements are based on the **UIElement** class, and i
     element.click_at(x, y)
     element.hover
     element.hover_at(x, y)
+    element.scroll_to(position)
     element.drag_by(right_offset, down_offset)
     element.drag_and_drop(target, right_offset, down_offset)
 
@@ -638,11 +638,11 @@ navigated to by clicking associated links. One such Cucumber navigation scenario
 
     Scenario Outline:  Verify Home page navigation links
       Given I am on the Home page
-      When I click the <page_name> navigation link
-      Then I expect the <page_name> page to be correctly displayed
+      When I click the <page name> navigation link
+      Then I expect the <page name> page to be correctly displayed
     
       Examples:
-        |page_name          |
+        |page name          |
         |Registration       |
         |My Account         |
         |Terms & Conditions |
@@ -653,17 +653,17 @@ navigated to by clicking associated links. One such Cucumber navigation scenario
 In the above example, the step definitions associated with the 3 steps might be implemented using a `page_dispatcher` method using a
 `case` statement to parse the `page` parameter as in the example below:
 
-    Given(/^I am on the ([^\"]*) page$/) do |page_name|
+    Given(/^I am on the (.*) page$/) do |page_name|
       target_page = page_dispatcher(page_name)
       target_page.load_page
     end
     
-    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
+    When(/^I click the (.*) navigation link$/) do |link_name|
       target_page = page_dispatcher(link_name)
       target_page.navigate_to
     end
     
-    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
+    Then(/^I expect the (.*) page to be correctly displayed$/) do |page_name|
       target_page = page_dispatcher(page_name)
       target_page.verify_page_exists
       target_page.verify_page_ui
@@ -701,22 +701,22 @@ To use these **PageManager** methods, include the step definitions and code belo
 
     include TestCentricity
     
-    Given(/^I am on the ([^\"]*) page$/) do |page_name|
+    Given(/^I am on the (.*) page$/) do |page_name|
       target_page = PageManager.find_page(page_name)
       target_page.load_page
     end
     
-    When(/^I click the ([^\"]*) navigation link$/) do |page_name|
+    When(/^I click the (.*) navigation link$/) do |page_name|
       target_page = PageManager.find_page(page_name)
       target_page.navigate_to
     end
     
-    Then(/^I expect to see the ([^\"]*) page$/) do |page_name|
+    Then(/^I expect to see the (.*) page$/) do |page_name|
       target_page = PageManager.find_page(page_name)
       target_page.verify_page_exists
     end
     
-    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
+    Then(/^I expect the (.*) page to be correctly displayed$/) do |page_name|
       target_page = PageManager.find_page(page_name)
       target_page.verify_page_exists
       target_page.verify_page_ui
@@ -870,6 +870,38 @@ To use a local instance of the Chrome desktop browser to host the emulated mobil
 to `chrome`.
 
 
+#### User defined mobile device profiles
+
+User defined mobile device profiles can be specified in a `device.yml` file for testing locally hosted emulated mobile web browsers running in an instance
+of the Chrome desktop browser. The user specified device profiles must be located at `config/data/devices/devices.yml` as depicted below:
+
+    my_automation_project
+        ├── config
+        │   ├── data
+        │   │   └── devices
+        │   │       └── devices.yml
+        │   ├── locales
+        │   └── cucumber.yml
+        ├── downloads
+        ├── features
+        │   ├── step_definitions
+        │   ├── support
+        │   └── test_data
+        ├── Gemfile
+        └── README.md
+
+The format for a new device profile is:
+```
+  :new_device_profile:
+    :name: "New Device Name"
+    :os: (ios, android, kindle, or blackberry)
+    :type: (phone or tablet)
+    :css_width: css width in pixels
+    :css_height: css height in pixels
+    :default_orientation: (portrait or landscape)
+    :user_agent: "user agent string"
+```
+
 ### Selenium Grid and Dockerized Selenium Grid hosted desktop and emulated mobile web browsers
 
 For desktop and emulated mobile web browsers running on Selenium Grid or Dockerized Selenium Grid environments ([like Zalenium](https://opensource.zalando.com/zalenium/)), the following **Environment Variables** must be set
@@ -877,7 +909,7 @@ as described in the table below.
 
 **Environment Variable** | **Description**
 ---------------   | ----------------
-`WEB_BROWSER`     | Must be set to one of the following desktop browsers - `chrome`, `chrome_headless`, `firefox`, `ie`, `edge`, or `safari` or any of the mobile web browsers described above.
+`WEB_BROWSER`     | Must be set to one of the following desktop browsers - `chrome`, `chrome_headless`, or `firefox`, or any of the mobile web browsers described above.
 `SELENIUM`        | Must be set to `remote`
 `REMOTE_ENDPOINT` | Must be set to the URL of the Grid hub, which is usually `http://localhost:4444/wd/hub`
 

data/lib/testcentricity_web.rb

@@ -35,16 +35,6 @@ require 'testcentricity_web/web_elements/range'
 require 'testcentricity_web/web_elements/media'
 require 'testcentricity_web/web_elements/audio'
 require 'testcentricity_web/web_elements/video'
-require 'testcentricity_web/web_elements/cell_element'
-require 'testcentricity_web/web_elements/cell_button'
-require 'testcentricity_web/web_elements/cell_checkbox'
-require 'testcentricity_web/web_elements/cell_radio'
-require 'testcentricity_web/web_elements/cell_image'
-require 'testcentricity_web/web_elements/list_element'
-require 'testcentricity_web/web_elements/list_button'
-require 'testcentricity_web/web_elements/list_checkbox'
-require 'testcentricity_web/web_elements/list_radio'
-require 'testcentricity_web/web_elements/siebel_open_ui_helper'
 
 
 module TestCentricity

data/lib/testcentricity_web/browser_helper.rb

@@ -2,9 +2,11 @@ require 'yaml'
 
 
 module TestCentricity
-  module Browsers
+  class Browsers
     include Capybara::DSL
 
+    @devices = {}
+
     # Sets the size of the browser window.
     #
     # @param resolution [Array] the desired [width, height]
@@ -73,8 +75,8 @@ module TestCentricity
 
     def self.close_all_browser_instances
       Capybara.page.driver.browser.window_handles.each do |handle|
-        page.driver.browser.switch_to.window(handle)
-        page.driver.browser.close
+        Capybara.page.driver.browser.switch_to.window(handle)
+        Capybara.page.driver.browser.close
       end
     end
 
@@ -126,17 +128,15 @@ module TestCentricity
       end
     end
 
-    def self.mobile_device_agent(device)
-      device_name = device.gsub(/\s+/, '').downcase.to_sym
-      device = get_devices[device_name]
+    def self.mobile_device_agent(browser)
+      device = get_device(browser)
       agent_string = device[:user_agent]
       raise "Device '#{device}' is not defined" unless agent_string
       agent_string
     end
 
-    def self.mobile_device_name(device)
-      device_name = device.gsub(/\s+/, '').downcase.to_sym
-      device = get_devices[device_name]
+    def self.mobile_device_name(browser)
+      device = get_device(browser)
       name = device[:name]
       raise "Device '#{device}' is not defined" unless name
       Environ.device_os = device[:os]
@@ -145,8 +145,7 @@ module TestCentricity
     end
 
     def self.browser_size(browser, orientation)
-      device_name = browser.gsub(/\s+/, '').downcase.to_sym
-      device = get_devices[device_name]
+      device = get_device(browser)
       if device
         width = device[:css_width]
         height = device[:css_height]
@@ -170,8 +169,17 @@ module TestCentricity
 
     private
 
-    def self.get_devices
-      YAML.load_file File.expand_path('../../devices/devices.yml', __FILE__)
+    def self.get_device(device)
+      if @devices.blank?
+        @devices = YAML.load_file File.expand_path('../../devices/devices.yml', __FILE__)
+        # read in user defined list of devices
+        external_device_file = 'config/data/devices/devices.yml'
+        unless File.size?(external_device_file).nil?
+          ext_devices = YAML.load_file(external_device_file)
+          @devices = @devices.merge(ext_devices)
+        end
+      end
+      @devices[device.gsub(/\s+/, '').downcase.to_sym]
     end
   end
 end

data/lib/testcentricity_web/data_objects/data_objects_helper.rb

@@ -5,8 +5,8 @@ require 'virtus'
 
 module TestCentricity
 
-  XL_PRIMARY_DATA_PATH ||= 'features/test_data/'
-  XL_PRIMARY_DATA_FILE ||= "#{XL_PRIMARY_DATA_PATH}data.xls"
+  PRIMARY_DATA_PATH ||= 'features/test_data/'
+  XL_PRIMARY_DATA_FILE ||= "#{PRIMARY_DATA_PATH}data.xls"
 
 
   class DataObject
@@ -81,7 +81,7 @@ module TestCentricity
     attr_accessor :node
 
     def read_yaml_node_data(file_name, node_name)
-      @file_path = "#{XL_PRIMARY_DATA_PATH}#{file_name}"
+      @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
       @node = node_name
       data = YAML.load_file(@file_path)
       data[node_name]
@@ -94,7 +94,7 @@ module TestCentricity
     end
 
     def read_json_node_data(file_name, node_name)
-      @file_path = "#{XL_PRIMARY_DATA_PATH}#{file_name}"
+      @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
       @node = node_name
       raw_data = File.read(@file_path)
       data = JSON.parse(raw_data)
@@ -117,7 +117,7 @@ module TestCentricity
       @worksheet = sheet
       if ENV['TEST_ENVIRONMENT']
         environment = ENV['TEST_ENVIRONMENT']
-        data_file = "#{XL_PRIMARY_DATA_PATH}#{environment}_data.xls"
+        data_file = "#{PRIMARY_DATA_PATH}#{environment}_data.xls"
         data_file = XL_PRIMARY_DATA_FILE unless ExcelData.row_spec_exists?(data_file, @worksheet, row_spec)
       else
         data_file = XL_PRIMARY_DATA_FILE

data/lib/testcentricity_web/data_objects/environment.rb

@@ -36,11 +36,14 @@ module TestCentricity
     attr_accessor :device_name
     attr_accessor :device_type
     attr_accessor :device_os
+    attr_accessor :device_os_version
     attr_accessor :device_orientation
     attr_accessor :platform
     attr_accessor :driver
     attr_accessor :grid
     attr_accessor :tunneling
+    attr_accessor :locale
+    attr_accessor :language
 
     attr_accessor :parallel
     attr_accessor :process_num
@@ -58,8 +61,12 @@ module TestCentricity
     attr_accessor :user_id
     attr_accessor :password
     attr_accessor :append
+    attr_accessor :app_id
+    attr_accessor :api_key
     attr_accessor :option1
     attr_accessor :option2
+    attr_accessor :option3
+    attr_accessor :option4
     attr_accessor :dns
     attr_accessor :db_username
     attr_accessor :db_password
@@ -71,12 +78,18 @@ module TestCentricity
       @user_id	     = data['USER_ID']
       @password	     = data['PASSWORD']
       @append	       = data['APPEND']
+      @app_id 	     = data['APP_ID']
+      @api_key	     = data['API_KEY']
       @option1	     = data['OPTIONAL_1']
       @option2	     = data['OPTIONAL_2']
+      @option3	     = data['OPTIONAL_3']
+      @option4	     = data['OPTIONAL_4']
       @dns	         = data['DNS']
       @db_username   = data['DB_USERNAME']
       @db_password   = data['DB_PASSWORD']
       @a11y_standard = ENV['ACCESSIBILITY_STANDARD'] || 'best-practice'
+      @locale        = ENV['LOCALE'] || 'en'
+      @language      = ENV['LANGUAGE'] || 'English'
 
       super
     end
@@ -205,6 +218,14 @@ module TestCentricity
       @device_os
     end
 
+    def self.device_os_version=(version)
+      @device_os_version = version
+    end
+
+    def self.device_os_version
+      @device_os_version
+    end
+
     def self.is_ios?
       @device_os == :ios
     end
@@ -245,6 +266,22 @@ module TestCentricity
       @tunneling
     end
 
+    def self.language=(language)
+      @language = language
+    end
+
+    def self.language
+      @language
+    end
+
+    def self.locale=(locale)
+      @locale = locale
+    end
+
+    def self.locale
+      @locale
+    end
+
     def self.platform=(platform)
       @platform = platform
     end
@@ -305,13 +342,13 @@ module TestCentricity
       report_header = "\n<b><u>TEST ENVIRONMENT</u>:</b> #{ENV['TEST_ENVIRONMENT']}\n"\
       "  <b>Browser:</b>\t #{Environ.browser.capitalize}\n"
       report_header = "#{report_header}  <b>Device:</b>\t\t #{Environ.device_name}\n" if Environ.device_name
-      report_header = "#{report_header}  <b>Device OS:</b>\t #{Environ.device_os}\n" if Environ.device_os
+      report_header = "#{report_header}  <b>Device OS:</b>\t #{Environ.device_os} #{Environ.device_os_version}\n" if Environ.device_os
       report_header = "#{report_header}  <b>Device type:</b>\t #{Environ.device_type}\n" if Environ.device_type
       report_header = "#{report_header}  <b>Driver:</b>\t\t #{Environ.driver}\n" if Environ.driver
       report_header = "#{report_header}  <b>Grid:</b>\t\t #{Environ.grid}\n" if Environ.grid
       report_header = "#{report_header}  <b>OS:</b>\t\t\t #{Environ.os}\n" if Environ.os
-      report_header = "#{report_header}  <b>Locale:</b>\t\t #{ENV['LOCALE']}\n" if ENV['LOCALE']
-      report_header = "#{report_header}  <b>Language:</b>\t #{ENV['LANGUAGE']}\n" if ENV['LANGUAGE']
+      report_header = "#{report_header}  <b>Locale:</b>\t\t #{Environ.locale}\n" if Environ.locale
+      report_header = "#{report_header}  <b>Language:</b>\t #{Environ.language}\n" if Environ.language
       report_header = "#{report_header}  <b>Country:</b>\t #{ENV['COUNTRY']}\n" if ENV['COUNTRY']
       report_header = "#{report_header}  <b>WCAG Accessibility Standard:</b>\t #{ENV['ACCESSIBILITY_STANDARD']}\n" if ENV['ACCESSIBILITY_STANDARD']
       "#{report_header}\n\n"