testcentricity_web 3.2.12 → 3.2.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45255a5e0001ea076f691aed9284b7c1eb4c9857aaa79dcf0845f82290b3bac7
-  data.tar.gz: 0ebd75ccb27af3be6f4146cf20897fe9be69cb5cdcaf9a0566d1c35c57e68585
+  metadata.gz: 967025c22dced2c769d460dbb4d6a20708293277b43887a82158c64f242686e9
+  data.tar.gz: 9db450d8190d44e31012c45fdad5236507bee75638f323e2bd42632758354743
 SHA512:
-  metadata.gz: 1336183ee836e42e58c0a971ebcd1e4c8eefe2b7cd11b5c7ddebb460426f4f23088d404f66929b5d5fd2255f312dd3c8b54982be45af5367db475a39756924b2
-  data.tar.gz: 1b352854c16a52970b1e335b1af43412710e9102a69ab70a01a3ebd39d9a6a7f3a3192caa491d063d65ccb7972854188e8672a3803b2da259838e4d3c2f18fce
+  metadata.gz: bdceb150bda3a9cfa267e3658a5332a76042deada8d57b58b5862f6b73b1c0e9a49721a7f7f57e99cae851626d67531290463acbd26eb2981193a4e1354bb18e
+  data.tar.gz: cc252a2ec353bc83d91dcd97a8d4c30f89b434107bbbde48d91a9937f5befe1ad9264e62409ac744f8372885f7c67d52bf10260a25c0b45927783a2a8bbf351d

data/CHANGELOG.md

@@ -1,6 +1,35 @@
 # CHANGELOG
 All notable changes to this project will be documented in this file.
 
+## [3.2.17] - 19-JUNE-2020
+
+### Changed
+* Updated `Table.define_table_elements` method to accept value for `:row_header` element.
+* Updated `Table.get_row_count`, `Table.get_column_count`, and `Table.get_table_cell_locator` methods to support tables
+with row headers in row #1.
+
+## [3.2.16] - 13-MAY-2020
+
+### Changed
+* `WebDriverConnect.initialize_web_driver` method now sets local Chrome and Firefox browser Download directory to separate
+folders for each parallel test thread when using `parallel_tests` gem to run tests in concurrent threads.
+
+## [3.2.15] - 06-APR-2020
+
+### Fixed
+* `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods accept `String` or `Boolean` values
+for checkboxes and radio buttons.
+
+## [3.2.14] - 06-APR-2020
+
+### Added
+* Added `UIElement.scroll_to` method.
+
+## [3.2.13] - 24-MAR-2020
+
+### Added
+* Added `PageObject.send_keys` method.
+
 ## [3.2.12] - 11-MAR-2020
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (3.2.12)
+    testcentricity_web (3.2.17)
       appium_lib
       browserstack-local
       capybara (>= 3.1, < 4)
@@ -21,11 +21,11 @@ GEM
   specs:
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
-    appium_lib (10.5.0)
+    appium_lib (10.6.0)
       appium_lib_core (~> 3.3)
       nokogiri (~> 1.8, >= 1.8.1)
       tomlrb (~> 1.1)
-    appium_lib_core (3.5.0)
+    appium_lib_core (3.10.0)
       faye-websocket (~> 0.10.0)
       selenium-webdriver (~> 3.14, >= 3.14.1)
     axiom-types (0.1.1)
@@ -33,7 +33,7 @@ GEM
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
     browserstack-local (1.3.0)
-    capybara (3.31.0)
+    capybara (3.32.2)
       addressable
       mini_mime (>= 0.1.3)
       nokogiri (~> 1.8)
@@ -51,51 +51,51 @@ GEM
       thread_safe (~> 0.3, >= 0.3.1)
     equalizer (0.0.11)
     eventmachine (1.2.7)
-    faker (2.10.2)
+    faker (2.12.0)
       i18n (>= 1.6, < 2)
     faye-websocket (0.10.9)
       eventmachine (>= 0.12.0)
       websocket-driver (>= 0.5.1)
-    ffi (1.12.2)
-    i18n (1.8.2)
+    ffi (1.13.1)
+    i18n (1.8.3)
       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.0.1)
-    power_assert (1.1.6)
-    public_suffix (4.0.3)
-    rack (2.2.2)
+    os (1.1.0)
+    power_assert (1.2.0)
+    public_suffix (4.0.5)
+    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.0)
+    regexp_parser (1.7.1)
     ruby-ole (1.2.12.2)
-    rubyzip (2.2.0)
+    rubyzip (2.3.0)
     selenium-webdriver (3.142.7)
       childprocess (>= 0.5, < 4.0)
       rubyzip (>= 1.2.2)
     spreadsheet (1.1.7)
       ruby-ole (>= 1.0)
-    test-unit (3.3.5)
+    test-unit (3.3.6)
       power_assert
     thread_safe (0.3.6)
-    tomlrb (1.2.9)
+    tomlrb (1.3.0)
     virtus (1.0.5)
       axiom-types (~> 0.1)
       coercible (~> 1.0)
       descendants_tracker (~> 0.0, >= 0.0.3)
       equalizer (~> 0.0, >= 0.0.9)
-    webdrivers (4.2.0)
+    webdrivers (4.4.1)
       nokogiri (~> 1.6)
       rubyzip (>= 1.3.0)
       selenium-webdriver (>= 3.0, < 4.0)
-    websocket-driver (0.7.1)
+    websocket-driver (0.7.2)
       websocket-extensions (>= 0.1.0)
-    websocket-extensions (0.1.4)
+    websocket-extensions (0.1.5)
     xpath (3.2.0)
       nokogiri (~> 1.8)
 

data/README.md

@@ -776,6 +776,25 @@ a `/downloads` folder at the same level as the `/config` and `/features` folders
         └── README.md
 
 
+When running tests in multiple concurrent threads using the `parallel_tests` gem, a new folder will be created within the `/downloads` folder for each
+test thread. This is to ensure that files downloaded in each test thread are isolated from tests running in other parallel threads. An example of the
+`/downloads` folder structure for 4 parallel threads is depicted below:
+
+    my_automation_project
+        ├── config
+        ├── downloads
+        │   ├── 1
+        │   ├── 2
+        │   ├── 3
+        │   └── 4
+        ├── features
+        │   ├── step_definitions
+        │   ├── support
+        │   └── test_data
+        ├── Gemfile
+        └── README.md
+
+
 When testing file downloads using a local instance of Firefox, you will need to specify the MIME types of the various file types that your tests will
 be downloading. This is accomplished by setting the `MIME_TYPES` Environment Variable to a comma-delimited string containing the list of MIME types to
 be accepted. This list is required as it will prevent Firefox from displaying the File Download modal dialog, which will halt your automated tests. An

data/lib/testcentricity_web/data_objects/environment.rb

@@ -42,6 +42,9 @@ module TestCentricity
     attr_accessor :grid
     attr_accessor :tunneling
 
+    attr_accessor :parallel
+    attr_accessor :process_num
+
     attr_accessor :signed_in
     attr_accessor :portal_status
     attr_accessor :portal_context
@@ -94,6 +97,22 @@ module TestCentricity
       @session_time_stamp
     end
 
+    def self.parallel=(state)
+      @parallel = state
+    end
+
+    def self.parallel
+      @parallel
+    end
+
+    def self.process_num=(num)
+      @process_num = num
+    end
+
+    def self.process_num
+      @process_num
+    end
+
     def self.test_environment
       if @test_environment.blank?
         nil

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.2.12'
+  VERSION = '3.2.17'
 end

data/lib/testcentricity_web/web_core/page_object.rb

@@ -481,6 +481,17 @@ module TestCentricity
       page.driver.browser.title
     end
 
+    # Send keystrokes to the focused element on a Page object
+    #
+    # @param keys [String] keys
+    # @example
+    #   editor_page.send_keys([:control, 'z'])
+    #
+    def send_keys(*keys)
+      focused_obj = page.driver.browser.switch_to.active_element
+      focused_obj.send_keys(*keys)
+    end
+
     # Wait until the page object exists, or until the specified wait time has expired. If the wait time is nil, then the wait
     # time will be Capybara.default_max_wait_time.
     #

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -279,7 +279,8 @@ module TestCentricity
           else
             case data_field.get_object_type
             when :checkbox
-              data_field.set_checkbox_state(data_param.to_bool)
+              check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
+              data_field.set_checkbox_state(check_state)
             when :selectlist
               if data_field.get_siebel_object_type == 'JComboBox'
                 data_field.set("#{data_param}\t")
@@ -287,7 +288,8 @@ module TestCentricity
                 data_field.choose_option(data_param)
               end
             when :radio
-              data_field.set_selected_state(data_param.to_bool)
+              check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
+              data_field.set_selected_state(check_state)
             when :textfield
               data_field.set("#{data_param}\t")
               if integrity_check && data_field.get_value != data_param

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -2,6 +2,7 @@ require 'selenium-webdriver'
 require 'os'
 require 'browserstack/local'
 require 'webdrivers'
+require 'fileutils'
 
 
 module TestCentricity
@@ -16,6 +17,14 @@ module TestCentricity
       browser = ENV['WEB_BROWSER']
       # set downloads folder path
       @downloads_path = "#{Dir.pwd}/downloads"
+      if ENV['PARALLEL']
+        Environ.parallel = true
+        Environ.process_num = ENV['TEST_ENV_NUMBER']
+        @downloads_path = "#{@downloads_path}/#{ENV['TEST_ENV_NUMBER']}"
+        Dir.mkdir(@downloads_path) unless Dir.exist?(@downloads_path)
+      else
+        Environ.parallel = false
+      end
       @downloads_path = @downloads_path.tr('/', "\\") if OS.windows?
 
       # assume that we're testing within a local desktop web browser
@@ -26,37 +35,37 @@ module TestCentricity
       Environ.device      = :web
       Environ.device_name = 'browser'
 
-      case browser.downcase.to_sym
-      when :appium
-        initialize_appium
-        context = 'mobile device emulator'
-      when :browserstack
-        initialize_browserstack
-        context = 'Browserstack cloud service'
-      when :crossbrowser
-        initialize_crossbrowser
-        context = 'CrossBrowserTesting cloud service'
-      when :gridlastic
-        initialize_gridlastic
-        context = 'Gridlastic cloud service'
-      when :lambdatest
-        initialize_lambdatest
-        context = 'LambdaTest cloud service'
-      when :saucelabs
-        initialize_saucelabs
-        context = 'Sauce Labs cloud service'
-      when :testingbot
-        initialize_testingbot
-        context = 'TestingBot cloud service'
-      else
-        if ENV['SELENIUM'] == 'remote'
-          initialize_remote
-          context = 'Selenium Grid'
-        else
-          initialize_local_browser
-          context = 'local browser instance'
-        end
-      end
+      context = case browser.downcase.to_sym
+                when :appium
+                  initialize_appium
+                  'mobile device emulator'
+                when :browserstack
+                  initialize_browserstack
+                  'Browserstack cloud service'
+                when :crossbrowser
+                  initialize_crossbrowser
+                  'CrossBrowserTesting cloud service'
+                when :gridlastic
+                  initialize_gridlastic
+                  'Gridlastic cloud service'
+                when :lambdatest
+                  initialize_lambdatest
+                  'LambdaTest cloud service'
+                when :saucelabs
+                  initialize_saucelabs
+                  'Sauce Labs cloud service'
+                when :testingbot
+                  initialize_testingbot
+                  'TestingBot cloud service'
+                else
+                  if ENV['SELENIUM'] == 'remote'
+                    initialize_remote
+                    'Selenium Grid'
+                  else
+                    initialize_local_browser
+                    'local browser instance'
+                  end
+                end
 
       # set browser window size only if testing with a desktop web browser
       unless Environ.is_device? || Capybara.current_driver == :appium
@@ -169,11 +178,11 @@ module TestCentricity
     end
 
     def self.initialize_local_browser
-      if OS.osx?
-        Environ.os = 'OS X'
-      elsif OS.windows?
-        Environ.os = 'Windows'
-      end
+      Environ.os = if OS.osx?
+                     'OS X'
+                   elsif OS.windows?
+                     'Windows'
+                   end
 
       browser = ENV['WEB_BROWSER'].downcase.to_sym
 

data/lib/testcentricity_web/web_elements/table.rb

@@ -7,6 +7,7 @@ module TestCentricity
     attr_accessor :table_header
     attr_accessor :header_row
     attr_accessor :header_column
+    attr_accessor :row_header
     attr_accessor :tree_expand
     attr_accessor :tree_collapse
 
@@ -21,7 +22,8 @@ module TestCentricity
         table_column:  'td',
         table_header:  'thead',
         header_row:    'tr',
-        header_column: 'th'
+        header_column: 'th',
+        row_header:    nil
       }
 
       case @locator_type
@@ -52,6 +54,8 @@ module TestCentricity
           @header_row = value
         when :header_column
           @header_column = value
+        when :row_header
+          @row_header = value
         when :tree_expand
           @tree_expand = value
         when :tree_collapse
@@ -70,20 +74,18 @@ module TestCentricity
     #
     def get_row_count
       wait_until_exists(5)
-      case @locator_type
-      when :xpath
-        if @table_section.nil?
-          page.all(:xpath, "#{@locator}/#{@table_body}/#{@table_row}", visible: :all).count
-        else
-          page.all(:xpath, "#{@locator}/#{@table_body}/#{@table_section}", visible: :all).count
-        end
-      when :css
-        if @table_section.nil?
-          page.all(:css, "#{@locator} > #{@table_body} > #{@table_row}", visible: :all).count
-        else
-          page.all(:css, "#{@locator} > #{@table_body} > #{@table_section}", visible: :all).count
-        end
-      end
+      delimiter = case @locator_type
+                  when :xpath
+                    "/"
+                  when :css
+                    " > "
+                  end
+      path = if @table_section.nil?
+               "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_row}"
+             else
+               "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_section}"
+             end
+      page.all(@locator_type, path, visible: :all).count
     end
 
     # Wait until the table's row count equals the specified value, or until the specified wait time has expired. If the wait
@@ -138,33 +140,48 @@ module TestCentricity
       row_count = get_row_count
       case @locator_type
       when :xpath
-        if row_count.zero?
-          page.all(:xpath, "#{@locator}/#{@table_header}/#{@header_row}/#{@header_column}", visible: :all).count
-        else
-          if @table_section.nil?
-            row_count == 1 ?
-                page.all(:xpath, "#{@locator}/#{@table_body}/#{@table_row}/#{@table_column}", visible: :all).count :
-                page.all(:xpath, "#{@locator}/#{@table_body}/#{@table_row}[2]/#{@table_column}", visible: :all).count
-          else
-            row_count == 1 ?
-                page.all(:xpath, "#{@locator}/#{@table_body}/#{@table_section}/#{@table_row}/#{@table_column}", visible: :all).count :
-                page.all(:xpath, "#{@locator}/#{@table_body}/#{@table_section}[2]/#{@table_row}/#{@table_column}", visible: :all).count
-          end
-        end
+        delimiter = "/"
+        index = "[2]"
       when :css
-        if row_count.zero?
-          page.all(:css, "#{@locator} > #{@table_header} > #{@header_row} > #{@header_column}", visible: :all).count
-        else
-          if @table_section.nil?
-            row_count == 1 ?
-                page.all(:css, "#{@locator} > #{@table_body} > #{@table_row} > #{@table_column}", visible: :all).count :
-                page.all(:css, "#{@locator} > #{@table_body} > #{@table_row}:nth-of-type(2) > #{@table_column}", visible: :all).count
-          else
-            row_count == 1 ?
-                page.all(:css, "#{@locator} > #{@table_body} > #{@table_section} > #{@table_row} > #{@table_column}", visible: :all).count :
-                page.all(:css, "#{@locator} > #{@table_body} > #{@table_section}:nth-of-type(2) > #{@table_row} > #{@table_column}", visible: :all).count
-          end
-        end
+        delimiter = " > "
+        index = ":nth-of-type(2)"
+      end
+      path = if row_count.zero?
+               "#{@locator}#{delimiter}#{@table_header}#{delimiter}#{@header_row}#{delimiter}#{@header_column}"
+             else
+               if @table_section.nil?
+                 if row_count == 1
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_row}#{delimiter}#{@table_column}"
+                 else
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_row}#{index}#{delimiter}#{@table_column}"
+                 end
+               else
+                 if row_count == 1
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_section}#{delimiter}#{@table_row}#{delimiter}#{@table_column}"
+                 else
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_section}#{index}#{delimiter}#{@table_row}#{delimiter}#{@table_column}"
+                 end
+               end
+             end
+      if @row_header.nil?
+        page.all(@locator_type, path, visible: :all).count
+      else
+        cols = page.all(@locator_type, path, visible: :all).count
+
+        path = if @table_section.nil?
+                 if row_count == 1
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_row}#{delimiter}#{@row_header}"
+                 else
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_row}#{index}#{delimiter}#{@row_header}"
+                 end
+               else
+                 if row_count == 1
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_section}#{delimiter}#{@table_row}#{delimiter}#{@row_header}"
+                 else
+                   "#{@locator}#{delimiter}#{@table_body}#{delimiter}#{@table_section}#{index}#{delimiter}#{@table_row}#{delimiter}#{@row_header}"
+                 end
+               end
+        cols + page.all(@locator_type, path, visible: :all).count
       end
     end
 
@@ -615,7 +632,15 @@ module TestCentricity
           row_spec = "#{@locator}/#{@table_body}/#{@table_section}"
           row_spec = "#{row_spec}[#{row}]/#{@table_row}[1]"
         end
-        column_spec = "/#{@table_column}[#{column}]"
+        column_spec = if @row_header.nil?
+                        "/#{@table_column}[#{column}]"
+                      else
+                        if column == 1
+                          "/#{@row_header}"
+                        else
+                          "/#{@table_column}[#{column - 1}]"
+                        end
+                      end
       when :css
         if @table_section.nil?
           row_spec = "#{@locator} > #{@table_body} > #{@table_row}"
@@ -624,7 +649,16 @@ module TestCentricity
           row_spec = "#{@locator} > #{@table_body} > #{@table_section}"
           row_spec = "#{row_spec}:nth-of-type(#{row}) > #{@table_row}:nth-of-type(1)"
         end
-        column_spec = " > #{@table_column}:nth-of-type(#{column})"
+
+        column_spec = if @row_header.nil?
+                        " > #{@table_column}:nth-of-type(#{column})"
+                      else
+                        if column == 1
+                          " > #{@row_header}"
+                        else
+                          " > #{@table_column}:nth-of-type(#{column - 1})"
+                        end
+                      end
       end
       "#{row_spec}#{column_spec}"
     end

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -158,6 +158,18 @@ module TestCentricity
       obj.click_at(x, y)
     end
 
+    # Scroll the object to its top, middle, or bottom
+    #
+    # @param position [Symbol] :top, :bottom, :center
+    # @example
+    #   cue_list.scroll_to(:bottom)
+    #
+    def scroll_to(position)
+      obj, type = find_element
+      object_not_found_exception(obj, type)
+      obj.scroll_to(position)
+    end
+
     def set(value)
       obj, type = find_element
       object_not_found_exception(obj, type)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.2.12
+  version: 3.2.17
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-11 00:00:00.000000000 Z
+date: 2020-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler