testcentricity_web 3.2.16 → 3.2.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 365b55689ded4886c7c52ca8ccb95e8bce18f6c33b6d08fc6872c26b88c2a7e7
-  data.tar.gz: 534bce4c71c825e0ba51548b180982428ca8d315f58d62752907203271907ce1
+  metadata.gz: aa65a9fd864b32c3b3b83f570ae9a6990d6b2072b75935fcf8489e26ff5cb759
+  data.tar.gz: da08a618537d5dc3930c3c5740d5a05a73dab8a017ad497cec4aa154956d162d
 SHA512:
-  metadata.gz: 5010441fe14bc169b4f8b51ace3fbed1ace9320cf7882d7529e274640ac327032b704b3cea1e9a64eb25e1966f4a5105070f48c2d8fbb94adb4c4752243e8442
-  data.tar.gz: 75d127eeddce7949fe2d09f265e25d811a9a6f5789632f9ecbe8dc7eef04d78bfe14216188742f208920887a9b64fa96ef29427dbc548a9fb11c3c6bbfc8d6dc
+  metadata.gz: 2d6968587d9580dea196021b2b4631b690393b4300883c3e036a5df215ae8f679e1f51bdda1c38f2aa7a221f374ee0bdc400fe7f9a7db4e31a8bcac9675b84ef
+  data.tar.gz: a6ff4c34c5260f4bd8dbaef959635ff79723587e2de0498255a749593778536e867264e8fab13e97dfcf315b9fca4cc711e1d77c1feb277738d2defcba8db305

data/CHANGELOG.md

@@ -1,6 +1,37 @@
 # CHANGELOG
 All notable changes to this project will be documented in this file.
 
+
+## [3.2.21] - 04-FEB-2021
+
+### Changed
+* `UIElement.hover_at` method now accepts an optional `visible` parameter to allow hovering over UI elements that are not
+  visible.
+
+## [3.2.20] - 21-JAN-2021
+
+### Changed
+* `UIElement.hover` method now accepts an optional `visible` parameter to allow hovering over UI elements that are not
+visible.
+
+## [3.2.19] - 05-JAN-2021
+
+### Fixed
+* `SelectList.choose_option` and `SelectList.get_options` methods now wait up to 5 seconds for list drop menu to appear.
+
+## [3.2.18] - 12-AUG-2020
+
+### Fixed
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to correctly handle `:row`, `:column`,
+`:cell`, `:item`, and `:attribute` properties.
+
+## [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

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (3.2.16)
+    testcentricity_web (3.2.21)
       appium_lib
       browserstack-local
       capybara (>= 3.1, < 4)
@@ -25,7 +25,7 @@ GEM
       appium_lib_core (~> 3.3)
       nokogiri (~> 1.8, >= 1.8.1)
       tomlrb (~> 1.1)
-    appium_lib_core (3.7.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.32.1)
+    capybara (3.32.2)
       addressable
       mini_mime (>= 0.1.3)
       nokogiri (~> 1.8)
@@ -51,13 +51,13 @@ GEM
       thread_safe (~> 0.3, >= 0.3.1)
     equalizer (0.0.11)
     eventmachine (1.2.7)
-    faker (2.11.0)
+    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)
@@ -67,12 +67,12 @@ GEM
     os (1.1.0)
     power_assert (1.2.0)
     public_suffix (4.0.5)
-    rack (2.2.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.0)
+    regexp_parser (1.7.1)
     ruby-ole (1.2.12.2)
     rubyzip (2.3.0)
     selenium-webdriver (3.142.7)
@@ -80,7 +80,7 @@ GEM
       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.3.0)
@@ -89,13 +89,13 @@ GEM
       coercible (~> 1.0)
       descendants_tracker (~> 0.0, >= 0.0.3)
       equalizer (~> 0.0, >= 0.0.9)
-    webdrivers (4.3.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/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2020, Tony Mrozinski
+Copyright (c) 2014-2021, Tony Mrozinski
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -778,7 +778,7 @@ a `/downloads` folder at the same level as the `/config` and `/features` folders
 
 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 paralle threads is depicted below:
+`/downloads` folder structure for 4 parallel threads is depicted below:
 
     my_automation_project
         ├── config
@@ -1673,7 +1673,7 @@ landscape orientation running on the BrowserStack service:
 
 ## Copyright and License
 
-TestCentricity™ Framework is Copyright (c) 2014-2020, Tony Mrozinski.
+TestCentricity™ Framework is Copyright (c) 2014-2021, Tony Mrozinski.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.2.16'
+  VERSION = '3.2.21'
 end

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -209,7 +209,7 @@ module TestCentricity
                      ui_object.content_editable?
                    else
                      if property.is_a?(Hash)
-                       property.each do |key, value|
+                       property.map do |key, value|
                          case key
                          when :cell
                            ui_object.get_table_cell(value[0].to_i, value[1].to_i)

data/lib/testcentricity_web/web_elements/select_list.rb

@@ -68,7 +68,7 @@ module TestCentricity
 
       unless @options_list.nil?
         find_component(@options_list, 'drop menu')
-        raise "Could not find option #{option} to choose" unless first(:css, @list_item, minimum: 0, wait: 2)
+        raise "Could not find option #{option} to choose" unless first(:css, @list_item, minimum: 0, wait: 5)
 
         if option.is_a?(Array)
           option.each do |item|
@@ -344,7 +344,7 @@ module TestCentricity
         element = @base_object.find(:css, component, minimum: 0, wait: 1)
       rescue
         begin
-          element = page.find(:css, component, minimum: 0, wait: 1)
+          element = page.find(:css, component, minimum: 0, wait: 5)
         rescue
           raise "List #{component_name} (#{component}) for selectlist named '#{@name}' (#{locator}) not found"
         end

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

@@ -528,11 +528,17 @@ module TestCentricity
 
     # Hover the cursor over an object
     #
+    # @param visible [Boolean, Symbol] Only find elements with the specified visibility:
+    #                                    * true - only finds visible elements.
+    #                                    * false - finds invisible _and_ visible elements.
+    #                                    * :all - same as false; finds visible and invisible elements.
+    #                                    * :hidden - only finds invisible elements.
+    #                                    * :visible - same as true; only finds visible elements.
     # @example
     #   basket_link.hover
     #
-    def hover
-      obj, type = find_element
+    def hover(visible = true)
+      obj, type = find_element(visible)
       object_not_found_exception(obj, type)
       obj.hover
     end
@@ -541,11 +547,17 @@ module TestCentricity
     #
     # @param x [Integer] X offset
     # @param y [Integer] Y offset
+    # @param visible [Boolean, Symbol] Only find elements with the specified visibility:
+    #                                    * true - only finds visible elements.
+    #                                    * false - finds invisible _and_ visible elements.
+    #                                    * :all - same as false; finds visible and invisible elements.
+    #                                    * :hidden - only finds invisible elements.
+    #                                    * :visible - same as true; only finds visible elements.
     # @example
     #   timeline_bar.hover_at(100, 5)
     #
-    def hover_at(x, y)
-      obj, = find_element
+    def hover_at(x, y, visible = true)
+      obj, = find_element(visible)
       raise "UI #{object_ref_message} not found" unless obj
       obj.hover_at(x, y)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.2.16
+  version: 3.2.21
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-13 00:00:00.000000000 Z
+date: 2021-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler