testcentricity_web 4.1.7 → 4.1.8

data/features/support/pages/{basic_test_page.rb → basic_form_page.rb}

@@ -1,8 +1,9 @@
-# Page Object class definition for Basic HTML Test page
+# Page Object class definition for Basic HTML Form page
 
-class BasicTestPage < BaseTestPage
+class BasicFormPage < BaseTestPage
   trait(:page_url)         { '/basic_test_page.html' }
   trait(:navigator)        { header_nav.open_form_page }
+  trait(:page_title)       { 'Basic HTML Form'}
   trait(:tab_order)        {
     [
       header_nav.form_link,
@@ -73,17 +74,44 @@ class BasicTestPage < BaseTestPage
   }
 
   def verify_page_ui
+    super
+
+    verify_page_contains(page_title)
+    image_1.wait_until_loaded(5)
+    username_field.scroll_to(:center) if username_field.obscured?
     ui = {
-      self              => { exists: true, secure: false, title: 'Basic HTML Form' },
-      header_label      => { visible: true, caption: 'Basic HTML Form Example' },
       username_label    => { visible: true, caption: 'Username:' },
-      username_field    => { visible: true, enabled: true, required: true, value: '', placeholder: 'User name' },
+      username_field    => {
+        name: 'username',
+        exists: true,
+        displayed: true,
+        obscured: false,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        required: true,
+        value: '',
+        placeholder: 'User name'
+      },
       password_label    => { visible: true, caption: 'Password:' },
-      password_field    => { visible: true, enabled: true, required: true, value: '', placeholder: 'Password' },
+      password_field    => {
+        name: 'password',
+        visible: true,
+        displayed: true,
+        obscured: false,
+        focused: false,
+        enabled: true,
+        required: true,
+        value: '',
+        placeholder: 'Password'
+      },
       max_length_label  => { visible: true, caption: 'Max Length:' },
       max_length_field  => {
         visible: true,
+        obscured: false,
         enabled: true,
+        focused: false,
         placeholder: 'up to 64 characters',
         value: '',
         maxlength: 64
@@ -119,15 +147,75 @@ class BasicTestPage < BaseTestPage
       filename_label    => { visible: true, caption: 'Filename:' },
       upload_file       => { visible: true, enabled: true, value: '' },
       checkboxes_label  => { visible: true, caption: 'Checkbox Items:' },
-      check_1           => { visible: true, enabled: true, checked: false },
-      check_2           => { visible: true, enabled: true, checked: false },
-      check_3           => { visible: true, enabled: true, checked: false },
-      check_4           => { visible: true, enabled: false, checked: false },
+      check_1           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        checked: false,
+        indeterminate: false
+      },
+      check_2           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        checked: false,
+        indeterminate: false
+      },
+      check_3           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        checked: false,
+        indeterminate: false
+      },
+      check_4           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: false,
+        disabled: true,
+        checked: false,
+        indeterminate: false
+      },
       radios_label      => { visible: true, caption: 'Radio Items:' },
-      radio_1           => { visible: true, enabled: true, selected: false },
-      radio_2           => { visible: true, enabled: true, selected: false },
-      radio_3           => { visible: true, enabled: true, selected: false },
-      radio_4           => { visible: true, enabled: false, selected: false },
+      radio_1           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        selected: false
+      },
+      radio_2           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        selected: false
+      },
+      radio_3           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: true,
+        disabled: false,
+        selected: false
+      },
+      radio_4           => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        enabled: false,
+        disabled: true,
+        selected: false
+      },
       multiselect_label => { visible: true, caption: 'Multiple Select Values:' },
       multi_select      => {
         visible: true,
@@ -158,6 +246,7 @@ class BasicTestPage < BaseTestPage
       link_3            => {
         visible: true,
         aria_disabled: true,
+        role: 'link',
         caption: 'Disabled Link'
       },
       table_label       => { visible: true, caption: 'Table:' },
@@ -169,17 +258,22 @@ class BasicTestPage < BaseTestPage
         { row: 1 } => [['Alfreds Futterkiste', 'Maria Anders', 'Germany']],
         { row: 2 } => [['Centro comercial Moctezuma', 'Francisco Chang', 'Mexico']],
         { row: 3 } => [['Ernst Handel', 'Roland Mendel', 'Austria']],
-        { row: 4 } => [['Island Trading', 'Helen Bennett', 'UK']]
+        { row: 4 } => [['Island Trading', 'Helen Bennett', 'UK']],
+        { cell: [1, 3] } => ['Germany'],
+        { cell: [2, 3] } => ['Mexico'],
+        { column: 3 } => [['Germany', 'Mexico', 'Austria', 'UK']]
       },
       images_label      => { visible: true, caption: 'Images:' },
       image_1           => {
         visible: true,
+        loaded: true,
         broken: false,
         src: { ends_with: 'images/Wilder.jpg' },
         alt: "It's alive"
       },
       image_2           => {
         visible: true,
+        loaded: true,
         broken: false,
         src: { ends_with: 'images/You_Betcha.jpg' },
         alt: 'You Betcha'
@@ -197,18 +291,20 @@ class BasicTestPage < BaseTestPage
   end
 
   def form_data
+    data = form_data_source.read_form_data
+
     if Environ.platform == :mobile
       file_path = nil
       file_name = ''
       color_value = '#000000'
     else
-      file_path = "#{Dir.pwd}/test_site/images/Wilder.jpg"
-      file_name = 'Wilder.jpg'
+      file_path = "#{Dir.pwd}/test_site/images/#{data.image_filename}"
+      file_name = data.image_filename
       color_value = Faker::Color.hex_color
     end
     {
-      username:     Faker::Name.name,
-      password:     'T0p_Sekrit',
+      username:     data.username,
+      password:     data.password,
       maxlength:    Faker::Marketing.buzzwords,
       number:       Faker::Number.between(from: 10, to: 1024),
       color:        color_value,
@@ -216,14 +312,14 @@ class BasicTestPage < BaseTestPage
       comments:     Faker::Hipster.paragraph,
       filepath:     file_path,
       filename:     file_name,
-      check1:       true,
-      check2:       true,
-      check3:       false,
+      check1:       data.check1,
+      check2:       data.check2,
+      check3:       data.check3,
       radio1:       false,
       radio2:       true,
       radio3:       false,
-      multi_select: 'Selection Item 2',
-      drop_select:  'Drop Down Item 5'
+      multi_select: data.multi_select,
+      drop_select:  data.drop_down_item
     }
   end
 

data/features/support/pages/{basic_xpath_test_page.rb → basic_xpath_form_page.rb}

@@ -1,7 +1,7 @@
-# Page Object class definition for Basic HTML Test page with Xpath locators
+# Page Object class definition for Basic HTML Form page with Xpath locators
 
-class BasicXpathTestPage < BasicTestPage
-  trait(:page_name)    { 'Basic Xpath Test' }
+class BasicXpathFormPage < BasicFormPage
+  trait(:page_name)    { 'Basic Xpath Form' }
   trait(:page_locator) { "//form[@id='HTMLFormElements']" }
 
   # Basic HTML Test page UI elements

data/features/support/pages/custom_controls_page.rb

@@ -5,12 +5,9 @@ class CustomControlsPage < BaseTestPage
   trait(:page_locator) { 'div.custom-controls-page-body' }
   trait(:page_url)     { '/custom_controls_page.html' }
   trait(:navigator)    { header_nav.open_custom_controls_page }
+  trait(:page_title)   { 'Custom Controls Page'}
 
   def verify_page_ui
-    ui = {
-      self         => { exists: true, secure: false, title: 'Custom Controls Page' },
-      header_label => { visible: true, caption: 'Custom Controls Page' }
-    }
-    verify_ui_states(ui)
+    super
   end
 end

data/features/support/pages/indexed_sections_page.rb

@@ -5,12 +5,9 @@ class IndexedSectionsPage < BaseTestPage
   trait(:page_locator) { 'div.indexed-sections-page-body' }
   trait(:page_url)     { '/indexed_sections_page.html' }
   trait(:navigator)    { header_nav.open_indexed_sections_page }
+  trait(:page_title)   { 'Indexed Sections Page'}
 
   def verify_page_ui
-    ui = {
-      self         => { exists: true, secure: false, title: 'Indexed Sections Page' },
-      header_label => { visible: true, caption: 'Indexed Sections Page' }
-    }
-    verify_ui_states(ui)
+    super
   end
 end

data/features/support/pages/media_test_page.rb

@@ -5,25 +5,29 @@ class MediaTestPage < BaseTestPage
   trait(:page_locator) { 'div.media-page-body' }
   trait(:page_url)     { '/media_page.html' }
   trait(:navigator)    { header_nav.open_media_page }
+  trait(:page_title)   { 'Media Page'}
 
   # Media Test page UI elements
-  videos video_player: 'video#video_player'
+  videos video_player_1: 'video#video_player1'
   audios audio_player: 'audio#audio_player'
 
   def verify_page_ui
+    super
+
     preload = case
-            when Environ.browser == :safari || Environ.device_os == :ios
-              'auto'
-            when Environ.browser == :firefox
-              ''
-            else
-              'metadata'
-            end
-    video_player.wait_until_ready_state_is(4, 10)
+              when Environ.browser == :safari
+                'auto'
+              when Environ.device_os == :ios && Environ.driver != :webdriver
+                'auto'
+              when %i[firefox firefox_headless].include?(Environ.browser)
+                ''
+              else
+                'metadata'
+              end
+    video_player_1.wait_until_ready_state_is(4, 10)
+    audio_player.wait_until_ready_state_is(4, 10)
     ui = {
-      self         => { exists: true, secure: false, title: 'Media Page' },
-      header_label => { visible: true, caption: 'Media Page' },
-      video_player => {
+      video_player_1 => {
         visible: true,
         paused: true,
         autoplay: false,
@@ -64,6 +68,14 @@ class MediaTestPage < BaseTestPage
       }
     }
     verify_ui_states(ui)
+    unless Environ.browser == :safari
+      ui = { video_player_1 => {
+          width: video_player_1.video_width,
+          height: video_player_1.video_height
+        }
+      }
+      verify_ui_states(ui)
+    end
   end
 
   def perform_action(media_type, action)
@@ -72,7 +84,7 @@ class MediaTestPage < BaseTestPage
     when :play
       player.play
       player.send_keys(:enter) if player.paused?
-      player.click if player.paused?
+      player.click_at(25, 25) if player.paused?
     when :pause
       player.pause
     when :mute
@@ -175,7 +187,7 @@ class MediaTestPage < BaseTestPage
   def dispatch_player(media_type)
     player = case media_type.downcase.to_sym
              when :video
-               video_player
+               video_player_1
              when :audio
                audio_player
              else
@@ -190,6 +202,7 @@ class MediaTestPage < BaseTestPage
     player.current_time = 0
     player.play
     player.send_keys(:enter) if player.paused?
+    player.click_at(25, 25) if player.paused?
     sleep(1)
   end
 end

data/features/support/sections/header_nav.rb

@@ -25,4 +25,15 @@ class NavHeader < TestCentricity::PageSection
   def open_custom_controls_page
     custom_controls_link.click
   end
+
+  def verify_nav_bar
+    ui = {
+      self => { exists: true, visible: true, class: 'topnav' },
+      form_link => { visible: true, caption: 'Basic HTML Form' },
+      media_link => { visible: true, caption: 'Media' },
+      indexed_sections_link => { visible: true, caption: 'Indexed Sections' },
+      custom_controls_link => { visible: true, caption: 'Custom Controls' },
+    }
+    verify_ui_states(ui)
+  end
 end

data/features/support/world_data.rb

@@ -4,7 +4,7 @@ module WorldData
   #  by the TestCentricity™ DataManager. Data Object class definitions are contained in the features/support/data folder.
   #
   def data_objects
-    {}
+    { form_data_source: FormDataSource }
   end
 end
 

data/features/support/world_pages.rb

@@ -5,8 +5,8 @@ module WorldPages
   #
   def page_objects
     {
-      basic_css_test_page:   BasicCSSTestPage,
-      basic_xpath_test_page: BasicXpathTestPage,
+      basic_css_form_page:   BasicCSSFormPage,
+      basic_xpath_form_page: BasicXpathFormPage,
       media_test_page:       MediaTestPage,
       indexed_sections_page: IndexedSectionsPage,
       custom_controls_page:  CustomControlsPage

data/lib/testcentricity_web/appium_server.rb

@@ -18,10 +18,12 @@ module TestCentricity
     def start
       # terminate any currently running Appium Server
       if running?
+        # :nocov:
         system('killall -9 node')
         puts 'Terminating existing Appium Server'
         sleep(5)
         puts 'Appium Server is being restarted'
+        # :nocov:
       else
         puts 'Appium Server is starting'
       end
@@ -56,6 +58,7 @@ module TestCentricity
 
     private
 
+    # :nocov:
     def parameters
       cmd = ['appium']
       @params.each do |key, value|
@@ -64,5 +67,7 @@ module TestCentricity
       end
       cmd
     end
+    # :nocov:
   end
 end
+

data/lib/testcentricity_web/data_objects/data_objects_helper.rb

@@ -52,6 +52,7 @@ module TestCentricity
       @current = current
     end
 
+# :nocov:
     def to_hash(node_name = nil)
       data = {}
       if node_name.nil?
@@ -79,9 +80,12 @@ module TestCentricity
     def write_json_data(file_name, mode, node_name = nil)
       File.open(file_name, mode) { |file| file.write(to_json(node_name)) }
     end
+
+# :nocov:
   end
 
 
+# :nocov:
   class DataSource
     attr_accessor :file_path
     attr_accessor :node
@@ -135,6 +139,7 @@ module TestCentricity
       result.to_s
     end
   end
+# :nocov:
 
 
   class ExcelDataSource < TestCentricity::DataSource
@@ -159,6 +164,7 @@ module TestCentricity
       ExcelData.read_row_data(pick_excel_data_source(sheet, @row_spec), sheet, @row_spec)
     end
 
+    # :nocov:
     def read_excel_pool_data(sheet, row_name, parallel = false)
       @row_spec = parallel == :parallel && ENV['PARALLEL'] ? "#{row_name}#{ENV['TEST_ENV_NUMBER']}" : row_name
       ExcelData.read_row_from_pool(pick_excel_data_source(sheet, row_name), sheet, @row_spec)
@@ -173,6 +179,7 @@ module TestCentricity
       @row_spec = parallel == :parallel && ENV['PARALLEL'] ? "#{row_name}#{ENV['TEST_ENV_NUMBER']}" : row_name
       ExcelData.write_row_data(pick_excel_data_source(sheet, @row_spec), sheet, @row_spec, row_data)
     end
+    # :nocov:
   end
 end
 

data/lib/testcentricity_web/data_objects/environment.rb

@@ -396,6 +396,7 @@ module TestCentricity
       @screen_shots = []
     end
 
+    # :nocov:
     def self.report_header
       report_header = "\n<b><u>TEST ENVIRONMENT</u>:</b> #{ENV['TEST_ENVIRONMENT']}\n"\
       "  <b>Browser:</b>\t #{Environ.browser.capitalize}\n"
@@ -411,6 +412,7 @@ module TestCentricity
       report_header = "#{report_header}  <b>WCAG Accessibility Standard:</b>\t #{ENV['ACCESSIBILITY_STANDARD']}\n" if ENV['ACCESSIBILITY_STANDARD']
       "#{report_header}\n\n"
     end
+    # :nocov:
   end
 end
 

data/lib/testcentricity_web/data_objects/excel_helper.rb

@@ -52,6 +52,65 @@ module TestCentricity
       exists
     end
 
+    def self.read_row_data(file, sheet, row_spec, columns = nil)
+      raise "File #{file} does not exists" unless File.exist?(file)
+      work_book  = Spreadsheet.open(file)
+      work_sheet = work_book.worksheet(sheet)
+      # get column headings from row 0 of worksheet
+      headings = work_sheet.row(0)
+      # if row_spec is a string then we have to find a matching row name
+      if row_spec.is_a? String
+        column_number = 0
+        found = false
+        headings.each do |heading|
+          if heading == 'ROW_NAME'
+            found = true
+            break
+          end
+          column_number += 1
+        end
+        raise "Could not find a column named ROW_NAME in worksheet #{sheet}" unless found
+        # find first cell in ROW_NAME column containing a string that matches the row_spec parameter
+        found = false
+        row_number = 0
+        work_sheet.each do |row|
+          if row[column_number] == row_spec
+            found = true
+            break
+          end
+          row_number += 1
+        end
+        raise "Could not find a row named '#{row_spec}' in worksheet #{sheet}" unless found
+        data = work_sheet.row(row_number)
+        # if row_spec is a number then ensure that it doesn't exceed the number of available rows
+      elsif row_spec.is_a? Numeric
+        raise "Row # #{row_spec} is greater than number of rows in worksheet #{sheet}" if row_spec > work_sheet.last_row_index
+        data = work_sheet.row(row_spec)
+      end
+
+      # if no columns have been specified, return all columns
+      columns = headings if columns.nil?
+      # create results hash table
+      result = Hash.new
+      columns.each do |column|
+        column_number = 0
+        found = false
+        headings.each do |heading|
+          if column == heading
+            value = data[column_number].to_s
+            value = calculate_dynamic_value(value) if value.start_with? 'eval!'
+            result[column] = value
+            found = true
+            break
+          end
+          column_number += 1
+        end
+        raise "Could not find a column named '#{column}' in worksheet #{sheet}" unless found
+      end
+      result
+    end
+
+    # :nocov:
     def self.read_row_from_pool(file, sheet, row_spec, columns = nil)
       raise "File #{file} does not exists" unless File.exist?(file)
       work_book  = Spreadsheet.open(file)
@@ -118,64 +177,6 @@ module TestCentricity
       read_row_data(file, sheet, new_row, columns)
     end
 
-    def self.read_row_data(file, sheet, row_spec, columns = nil)
-      raise "File #{file} does not exists" unless File.exist?(file)
-      work_book  = Spreadsheet.open(file)
-      work_sheet = work_book.worksheet(sheet)
-      # get column headings from row 0 of worksheet
-      headings = work_sheet.row(0)
-      # if row_spec is a string then we have to find a matching row name
-      if row_spec.is_a? String
-        column_number = 0
-        found = false
-        headings.each do |heading|
-          if heading == 'ROW_NAME'
-            found = true
-            break
-          end
-          column_number += 1
-        end
-        raise "Could not find a column named ROW_NAME in worksheet #{sheet}" unless found
-        # find first cell in ROW_NAME column containing a string that matches the row_spec parameter
-        found = false
-        row_number = 0
-        work_sheet.each do |row|
-          if row[column_number] == row_spec
-            found = true
-            break
-          end
-          row_number += 1
-        end
-        raise "Could not find a row named '#{row_spec}' in worksheet #{sheet}" unless found
-        data = work_sheet.row(row_number)
-        # if row_spec is a number then ensure that it doesn't exceed the number of available rows
-      elsif row_spec.is_a? Numeric
-        raise "Row # #{row_spec} is greater than number of rows in worksheet #{sheet}" if row_spec > work_sheet.last_row_index
-        data = work_sheet.row(row_spec)
-      end
-
-      # if no columns have been specified, return all columns
-      columns = headings if columns.nil?
-      # create results hash table
-      result = Hash.new
-      columns.each do |column|
-        column_number = 0
-        found = false
-        headings.each do |heading|
-          if column == heading
-            value = data[column_number].to_s
-            value = calculate_dynamic_value(value) if value.start_with? 'eval!'
-            result[column] = value
-            found = true
-            break
-          end
-          column_number += 1
-        end
-        raise "Could not find a column named '#{column}' in worksheet #{sheet}" unless found
-      end
-      result
-    end
-
     def self.read_range_data(file, sheet, range_spec)
       raise "File #{file} does not exists" unless File.exist?(file)
       work_book  = Spreadsheet.open(file)
@@ -270,6 +271,6 @@ module TestCentricity
       # rename new Excel document, replacing the original
       File.rename(outfile, file)
     end
+    # :nocov:
   end
 end
-

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.1.7'
+  VERSION = '4.1.8'
 end

data/lib/testcentricity_web/web_core/drag_drop_helper.rb

@@ -1,3 +1,5 @@
+# :nocov:
+
 module CapybaraExtension
   def drag_by(right_by, down_by)
     base.drag_by(right_by, down_by)
@@ -11,5 +13,7 @@ module CapybaraSeleniumExtension
   end
 end
 
+# :nocov:
+
 ::Capybara::Selenium::Node.send :include, CapybaraSeleniumExtension
 ::Capybara::Node::Element.send :include, CapybaraExtension

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -65,6 +65,8 @@ module TestCentricity
                      ui_object.hidden?
                    when :displayed
                      ui_object.displayed?
+                   when :obscured
+                     ui_object.obscured?
                    when :focused
                      ui_object.focused?
                    when :width
@@ -312,7 +314,7 @@ module TestCentricity
               check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
               data_field.set_selected_state(check_state)
             when :textfield
-              if data_field.get_attribute(:type) == 'color'
+              if %w[color number].include?(data_field.get_attribute(:type))
                 data_field.set(data_param)
               else
                 data_field.set("#{data_param}\t")