testcentricity_web 4.1.5 → 4.1.6

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -6,6 +6,26 @@ module TestCentricity
     include Capybara::Node::Matchers
     include Test::Unit::Assertions
 
+    attr_accessor :locator_type
+
+    XPATH_SELECTORS = ['//', '[@', '[contains(']
+    CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
+
+    def set_locator_type(locator = nil)
+      locator = @locator if locator.nil?
+      is_xpath = XPATH_SELECTORS.any? { |selector| locator.include?(selector) }
+      is_css = CSS_SELECTORS.any? { |selector| locator.include?(selector) }
+      @locator_type = if is_xpath && !is_css
+                        :xpath
+                      elsif is_css && !is_xpath
+                        :css
+                      elsif !is_css && !is_xpath
+                        :css
+                      else
+                        :css
+                      end
+    end
+
     # Define a trait for this page or section object.
     #
     # @param trait_name [Symbol] name of trait (as a symbol)
@@ -31,6 +51,8 @@ module TestCentricity
                      ui_object.get_attribute(:name)
                    when :title
                      ui_object.title
+                   when :secure
+                     ui_object.secure?
                    when :exists
                      ui_object.exists?
                    when :enabled
@@ -63,6 +85,8 @@ module TestCentricity
                      ui_object.indeterminate?
                    when :value, :caption
                      ui_object.get_value
+                   when :required
+                     ui_object.required?
                    when :maxlength
                      ui_object.get_max_length
                    when :rowcount
@@ -241,8 +265,11 @@ module TestCentricity
     end
 
     # Populate the specified UI elements on this page or section object with the associated data from a Hash passed as an
-    # argument. Data values must be in the form of a String for textfield and selectlist controls. For checkbox and radio
-    # buttons, data must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true, false).
+    # argument. Data values must be in the form of a String for textfield, selectlist, and filefield controls. For checkbox
+    # and radio buttons, data must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true,
+    # false). For range controls, data must be an Integer. For input(type='color') color picker controls, which are specified
+    # as a textfield, data must be in the form of a hex color String. For section objects, data values must be a String, and
+    # the section object must have a set method defined.
     #
     # The optional wait_time parameter is used to specify the time (in seconds) to wait for each UI element to become
     # visible before entering the associated data value. This option is useful in situations where entering data, or
@@ -285,14 +312,20 @@ module TestCentricity
               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_field.set('')
-                data_field.send_keys(data_param)
-                data_field.send_keys(:tab)
+              if data_field.get_attribute(:type) == 'color'
+                data_field.set(data_param)
+              else
+                data_field.set("#{data_param}\t")
+                if integrity_check && data_field.get_value != data_param
+                  data_field.set('')
+                  data_field.send_keys(data_param)
+                  data_field.send_keys(:tab)
+                end
               end
-            when :section
+            when :section, :range
               data_field.set(data_param)
+            when :filefield
+              data_field.file_upload(data_param)
             end
           end
         end

data/lib/testcentricity_web/web_core/page_section.rb

@@ -5,10 +5,6 @@ module TestCentricity
     attr_accessor :parent
     attr_accessor :parent_list
     attr_accessor :list_index
-    attr_accessor :locator_type
-
-    XPATH_SELECTORS = ['//', '[@', '[contains(']
-    CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
 
     def initialize(name, parent, locator, context)
       @name         = name
@@ -17,18 +13,7 @@ module TestCentricity
       @context      = context
       @parent_list  = nil
       @list_index   = nil
-
-      is_xpath = XPATH_SELECTORS.any? { |selector| @locator.include?(selector) }
-      is_css = CSS_SELECTORS.any? { |selector| @locator.include?(selector) }
-      @locator_type = if is_xpath && !is_css
-                        :xpath
-                      elsif is_css && !is_xpath
-                        :css
-                      elsif !is_css && !is_xpath
-                        :css
-                      else
-                        :css
-                      end
+      set_locator_type
     end
 
     def get_locator

data/lib/testcentricity_web/web_elements/select_list.rb

@@ -246,15 +246,23 @@ module TestCentricity
     def get_selected_option
       @base_object, = find_element
       object_not_found_exception(@base_object, nil)
-      trigger_list
+      trigger_list unless @options_list.nil?
       selection = if @base_object.first(:css, @list_item, minimum: 0, wait: 1, visible: :all)
                     @base_object.first(:css, @selected_item, wait: 1, visible: :all).text
                   elsif @base_object.first(:css, @selected_item, minimum: 0, wait: 1, visible: :all)
                     @base_object.first(:css, @selected_item, visible: :all).text
+                  elsif @base_object.first('option[selected]', minimum: 0, wait: 1, visible: :all)
+                    @base_object.first('option[selected]', wait: 1, visible: :all).text
                   else
-                    @base_object.first('option[selected]', visible: :all).text
+                    index = get_attribute(:selectedIndex).to_i
+                    if index >= 0
+                      options = get_options
+                      options[index]
+                    else
+                      ''
+                    end
                   end
-      trigger_list
+      trigger_list unless @options_list.nil?
       selection
     end
 

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -264,6 +264,19 @@ module TestCentricity
       obj.disabled?
     end
 
+    # Is UI object's required attribute set?
+    #
+    # @return [Boolean]
+    # @example
+    #   first_name_field.required?
+    #
+    def required?
+      obj, type = find_element
+      object_not_found_exception(obj, type)
+      state = get_attribute(:required)
+      state.boolean? ? state : state == 'true'
+    end
+
     # Is UI object obscured (not currently in viewport and not clickable)?
     #
     # @return [Boolean]

data/reports/.keep

@@ -0,0 +1 @@
+Placeholder file to allow the reports folder to be saved to repository. This folder is required for Jenkins test jobs using the Cucumber Reporting plug-in.

data/test_site/basic_test_page.html

@@ -0,0 +1,240 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Basic HTML Form</title>
+    <style>
+        table {
+            font-family: arial, sans-serif;
+            font-size: 15px;
+            border-collapse: collapse;
+            width: 85%;
+        }
+        td, th {
+            border: 1px solid #dddddd;
+            text-align: left;
+            padding: 8px;
+        }
+    </style>
+</head>
+    <body>
+        <div class="page-body">
+            <h1>Basic HTML Form Example</h1>
+            <div class="centered">
+                <form name="HTMLFormElements" id="HTMLFormElements">
+                    <table border="1" cellpadding="5">
+                        <tr>
+                            <td>
+                                <table>
+                                    <label id="inputs">Inputs:</label>
+                                    <tbody>
+                                        <tr>
+                                            <td>
+                                                <label for="username">Username:</label>
+                                                <input type="text" id="username" name="username" placeholder="User name" required>
+                                            </td>
+                                            <td>
+                                                <label for="password">Password:</label>
+                                                <input type="password" id="password" name="password" placeholder="Password" required>
+                                            </td>
+                                            <td>
+                                                <label for="maxlength">Max Length:</label>
+                                                <input type="text" id="maxlength" name="maxlength" placeholder="up to 64 characters" maxlength="64">
+                                            </td>
+                                        </tr>
+                                        <tr>
+                                            <td>
+                                                <label for="readonly">Read Only:</label>
+                                                <input type="text" id="readonly" name="readonly" value="I am a read only text field" readonly>
+                                            </td>
+                                            <td>
+                                                <label for="number-field">Number:</label>
+                                                <input id="number-field" type="number" name="number" min="10" max="1024" step="1" value="41">
+                                            </td>
+                                            <td>
+                                                <label for="color-picker">Color: </label>
+                                                <input id="color-picker" type="color" name="color">
+                                            </td>
+                                        </tr>
+                                        <tr>
+                                            <td>
+                                                <label for="slider">Range: </label>
+                                                <input id="slider" type="range" name="slider" min="0" max="50">
+                                            </td>
+                                            <td>
+                                            </td>
+                                            <td>
+                                            </td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                            </td>
+                        </tr>
+
+
+                        <tr>
+                            <td>
+                                <label for="comments">TextArea:</label>
+                                <textarea id="comments" name="comments" cols="80" rows="3"></textarea>
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <label for="filename">Filename:</label>
+                                <input type="file" id="filename" name="filename" size="35">
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <label id="checkboxes">Checkbox Items:</label>
+                                <input type="checkbox" id="check1" name="checkboxes[]" value="cb1" />Checkbox 1
+                                <input type="checkbox" id="check2" name="checkboxes[]" value="cb2" />Checkbox 2
+                                <input type="checkbox" id="check3" name="checkboxes[]" value="cb3" />Checkbox 3
+                                <input type="checkbox" id="check4" name="checkboxes[]" value="cb4" disabled/>Checkbox 4
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <label id="radios">Radio Items:</label>
+                                <input type="radio" id="radio1" name="radioval" value="rd1" />radio 1
+                                <input type="radio" id="radio2" name="radioval" value="rd2" />radio 2
+                                <input type="radio" id="radio3" name="radioval" value="rd3" />radio 3
+                                <input type="radio" id="radio4" name="radioval" value="rd4" disabled/>radio 4
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <label for="multipleselect">Multiple Select Values:</label>
+                                <select multiple="multiple" id="multipleselect" name="multipleselect" size="4">
+                                    <option value="ms1">Selection Item 1</option>
+                                    <option value="ms2">Selection Item 2</option>
+                                    <option value="ms3">Selection Item 3</option>
+                                    <option value="ms4">Selection Item 4</option>
+                                </select>
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <label for="dropdown">Dropdown:</label>
+                                <select id="dropdown" name="dropdown">
+                                    <option value="dd1">Drop Down Item 1</option>
+                                    <option value="dd2">Drop Down Item 2</option>
+                                    <option value="dd3">Drop Down Item 3</option>
+                                    <option value="dd4">Drop Down Item 4</option>
+                                    <option value="dd5">Drop Down Item 5</option>
+                                    <option value="dd6">Drop Down Item 6</option>
+                                </select>
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <label for="table">Table:</label>
+                                <table id="table">
+                                    <thead>
+                                        <tr>
+                                            <th>Company</th>
+                                            <th>Contact</th>
+                                            <th>Country</th>
+                                        </tr>
+                                    </thead>
+                                    <tbody>
+                                        <tr>
+                                            <td>Alfreds Futterkiste</td>
+                                            <td>Maria Anders</td>
+                                            <td>Germany</td>
+                                        </tr>
+                                        <tr>
+                                            <td>Centro comercial Moctezuma</td>
+                                            <td>Francisco Chang</td>
+                                            <td>Mexico</td>
+                                        </tr>
+                                        <tr>
+                                            <td>Ernst Handel</td>
+                                            <td>Roland Mendel</td>
+                                            <td>Austria</td>
+                                        </tr>
+                                        <tr>
+                                            <td>Island Trading</td>
+                                            <td>Helen Bennett</td>
+                                            <td>UK</td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                            </td>
+                        </tr>
+
+                        <tr>
+                            <td>
+                                <table>
+                                    <label id="images">Images:</label>
+                                    <tbody>
+                                        <tr>
+                                            <td>
+                                                <img id="image1" src="images/Wilder.jpg" alt="It's alive" style="width:225px;height:225px;">
+                                            </td>
+                                            <td>
+                                                <img id="image2" src="images/You_Betcha.jpg" alt="You Betcha" style="width:225px;height:225px;">
+                                            </td>
+                                            <td>
+                                                <img id="image3" src="wrongname.gif" alt="A broken image" style="width:225px;height:225px;">
+                                            </td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                            </td>
+                        </tr>
+
+
+
+                        <!--                        <tr>-->
+<!--                            <td>-->
+<!--                                <div class="form-label">-->
+<!--                                    <label for="date-picker">Date: </label>-->
+<!--                                    <input id="date-picker" type="date" name="date">-->
+<!--                                </div>-->
+<!--                            </td>-->
+<!--                        </tr>-->
+<!--                        <tr>-->
+<!--                            <td>-->
+<!--                                <div class="form-label">-->
+<!--                                    <label for="date-time-picker">Local date time:</label>-->
+<!--                                    <input id="date-time-picker" type="datetime-local" name="datetime" value="2018-01-01T01:01">-->
+<!--                                </div>-->
+<!--                            </td>-->
+<!--                        </tr>-->
+<!--                        <tr>-->
+<!--                            <td>-->
+<!--                                <div class="form-label">-->
+<!--                                    <label for="email-field">Email: </label>-->
+<!--                                    <input id="email-field" type="email" name="email" value="bob@mailinator.com">-->
+<!--                                </div>-->
+<!--                            </td>-->
+<!--                        </tr>-->
+<!--                        <tr>-->
+<!--                            <td>-->
+<!--                                <div class="form-label">-->
+<!--                                    <label for="month-field">Month: </label>-->
+<!--                                    <input id="month-field" type="month" name="month">-->
+<!--                                </div>-->
+<!--                            </td>-->
+<!--                        </tr>-->
+
+
+                        <tr>
+                            <td>
+                                <input type="reset" id="cancel" name="cancel" value="Cancel" class="styled-click-button">
+                                <input type="submit" id="submit" name="submit" value="Submit" class="styled-click-button">
+                            </td>
+                        </tr>
+                    </table>
+                </form>
+            </div>
+        </div>
+    </body>
+</html>

data/test_site/media_page.html

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <title>Media Page</title>
+        <style>
+            table {
+                font-family: arial, sans-serif;
+                font-size: 15px;
+                border-collapse: collapse;
+                width: 85%;
+            }
+            td, th {
+                border: 1px solid #dddddd;
+                text-align: left;
+                padding: 8px;
+            }
+        </style>
+    </head>
+    <body>
+        <div class="media-page-body">
+            <h1>Media Page</h1>
+            <video id="video_player" width="400" controls>
+                <source src="media/MP4_small.mp4" type="video/mp4">
+            </video>
+
+            <audio id="audio_player" controls>
+                <source src="media/MPS_sample.mp3" type="audio/mp3">
+            </audio>
+
+        </div>
+    </body>
+</html>

data/testcentricity_web.gemspec

@@ -29,6 +29,11 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'cucumber'
+  spec.add_development_dependency 'appium_capybara'
+  spec.add_development_dependency 'parallel_tests'
+  spec.add_development_dependency 'require_all'
+  spec.add_development_dependency 'simplecov', ['~> 0.18']
 
   spec.add_runtime_dependency 'appium_lib'
   spec.add_runtime_dependency 'browserstack-local'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.1.5
+  version: 4.1.6
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-15 00:00:00.000000000 Z
+date: 2022-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,6 +38,76 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: appium_capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: parallel_tests
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: require_all
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: appium_lib
   requirement: !ruby/object:Gem::Requirement
@@ -254,6 +324,7 @@ files:
 - ".idea/vcs.xml"
 - ".rspec"
 - ".rubocop.yml"
+- ".simplecov"
 - ".yardopts"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -262,6 +333,18 @@ files:
 - LICENSE.md
 - README.md
 - Rakefile
+- config/cucumber.yml
+- docker-compose-v3.yml
+- features/basic_test_page_css.feature
+- features/basic_test_page_xpath.feature
+- features/step_definitions/generic_steps.rb.rb
+- features/support/env.rb
+- features/support/hooks.rb
+- features/support/pages/basic_css_test_page.rb
+- features/support/pages/basic_test_page.rb
+- features/support/pages/basic_xpath_test_page.rb
+- features/support/pages/media_page.rb
+- features/support/world_pages.rb
 - lib/devices/devices.yml
 - lib/testcentricity_web.rb
 - lib/testcentricity_web/appium_server.rb
@@ -294,7 +377,14 @@ files:
 - lib/testcentricity_web/web_elements/ui_elements_helper.rb
 - lib/testcentricity_web/web_elements/video.rb
 - lib/testcentricity_web/world_extensions.rb
-- test_site/test_page.html
+- reports/.keep
+- test_site/basic_test_page.html
+- test_site/images/Granny.jpg
+- test_site/images/Wilder.jpg
+- test_site/images/You_Betcha.jpg
+- test_site/media/MP4_small.mp4
+- test_site/media/MPS_sample.mp3
+- test_site/media_page.html
 - testcentricity_web.gemspec
 homepage: ''
 licenses:
@@ -321,4 +411,14 @@ signing_key:
 specification_version: 4
 summary: A Page Object and Data Object Model Framework for desktop and mobile web
   testing
-test_files: []
+test_files:
+- features/basic_test_page_css.feature
+- features/basic_test_page_xpath.feature
+- features/step_definitions/generic_steps.rb.rb
+- features/support/env.rb
+- features/support/hooks.rb
+- features/support/pages/basic_css_test_page.rb
+- features/support/pages/basic_test_page.rb
+- features/support/pages/basic_xpath_test_page.rb
+- features/support/pages/media_page.rb
+- features/support/world_pages.rb

data/test_site/test_page.html

@@ -1,11 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <title>Indexed Property Page</title>
-</head>
-    <body>
-
-
-    </body>
-</html>