testcentricity_web 4.1.5 → 4.1.8

data/features/support/pages/media_test_page.rb

@@ -0,0 +1,208 @@
+# Page Object class definition for Media Test page with CSS locators
+
+class MediaTestPage < BaseTestPage
+  trait(:page_name)    { 'Media Test' }
+  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_1: 'video#video_player1'
+  audios audio_player: 'audio#audio_player'
+
+  def verify_page_ui
+    super
+
+    preload = case
+              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 = {
+      video_player_1 => {
+        visible: true,
+        paused: true,
+        autoplay: false,
+        loop: false,
+        ended: false,
+        controls: true,
+        current_time: 0,
+        ready_state: 4,
+        default_playback_rate: 1,
+        playback_rate: 1,
+        seeking: false,
+        default_muted: false,
+        muted: false,
+        volume: 1,
+        preload: preload,
+        poster: '',
+        src: '',
+        duration: 17.6
+      },
+      audio_player => {
+        visible: true,
+        paused: true,
+        autoplay: false,
+        loop: false,
+        ended: false,
+        controls: true,
+        current_time: 0,
+        ready_state: 4,
+        default_playback_rate: 1,
+        playback_rate: 1,
+        seeking: false,
+        default_muted: false,
+        muted: false,
+        volume: 1,
+        preload: preload,
+        src: '',
+        duration: 3.45
+      }
+    }
+    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)
+    player = dispatch_player(media_type)
+    case action.downcase.to_sym
+    when :play
+      player.play
+      player.send_keys(:enter) if player.paused?
+      player.click_at(25, 25) if player.paused?
+    when :pause
+      player.pause
+    when :mute
+      player.mute
+    when :unmute
+      player.unmute
+    else
+      raise "#{action} is not a valid selector"
+    end
+    sleep(2)
+  end
+
+  def verify_media_state(media_type, state)
+    player = dispatch_player(media_type)
+    duration = player.duration
+    props = case state.downcase.to_sym
+            when :playing
+              {
+                visible: true,
+                paused: false,
+                ended: false,
+                current_time: { greater_than: 0 },
+                seeking: false
+              }
+            when :paused
+              {
+                visible: true,
+                paused: true,
+                ended: false,
+                current_time: { greater_than: 0 },
+                seeking: false
+              }
+            when :ended
+              {
+                visible: true,
+                paused: true,
+                ended: true,
+                current_time: duration,
+                seeking: false
+              }
+            when :muted
+              {
+                visible: true,
+                muted: true
+              }
+            when :unmuted
+              {
+                visible: true,
+                muted: false
+              }
+            else
+              raise "#{state} is not a valid selector"
+            end
+    verify_ui_states(player => props)
+  end
+
+  def set_playback_rate(media_type, rate)
+    player = dispatch_player(media_type)
+    player.playback_rate = rate.to_f
+    reset_play(player)
+  end
+
+  def verify_playback_rate(media_type, rate)
+    player = dispatch_player(media_type)
+    ui = {
+      player => {
+        playback_rate: rate.to_f,
+        visible: true,
+        paused: false,
+        current_time: { greater_than: 0 },
+        seeking: false
+      }
+    }
+    verify_ui_states(ui)
+  end
+
+  def set_volume(media_type, volume)
+    player = dispatch_player(media_type)
+    player.volume = volume.to_f
+    reset_play(player)
+  end
+
+  def verify_volume(media_type, volume)
+    player = dispatch_player(media_type)
+    ui = {
+      player => {
+        volume: volume.to_f,
+        visible: true,
+        muted: false,
+        paused: false,
+        current_time: { greater_than: 0 },
+        seeking: false
+      }
+    }
+    verify_ui_states(ui)
+  end
+
+  private
+
+  def dispatch_player(media_type)
+    player = case media_type.downcase.to_sym
+             when :video
+               video_player_1
+             when :audio
+               audio_player
+             else
+               raise "#{media_type} is not a valid selector"
+             end
+    player.wait_until_ready_state_is(4, 10)
+    player
+  end
+
+  def reset_play(player)
+    player.pause
+    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

@@ -0,0 +1,39 @@
+# Section Object class definition for Top Navigation Bar
+
+class NavHeader < TestCentricity::PageSection
+  trait(:section_locator) { 'div#nav_bar' }
+  trait(:section_name)    { 'Top Navigation Bar' }
+
+  # Top Navigation Bar UI elements
+  links form_link:             'a#form_link',
+        media_link:            'a#media_link',
+        indexed_sections_link: 'a#indexed_sections_link',
+        custom_controls_link:  'a#custom_controls_link'
+
+  def open_form_page
+    form_link.click
+  end
+
+  def open_media_page
+    media_link.click
+  end
+
+  def open_indexed_sections_page
+    indexed_sections_link.click
+  end
+
+  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

@@ -0,0 +1,12 @@
+module WorldData
+  #
+  #  data_objects method returns a hash table of your web app's data objects and associated data object classes to be instantiated
+  #  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
+
+
+World(WorldData)

data/features/support/world_pages.rb

@@ -0,0 +1,18 @@
+module WorldPages
+  #
+  #  page_objects method returns a hash table of your web app's page objects and associated page classes to be instantiated
+  # by the TestCentricity™ PageManager. Page Object class definitions are contained in the features/support/pages folder.
+  #
+  def page_objects
+    {
+      basic_css_form_page:   BasicCSSFormPage,
+      basic_xpath_form_page: BasicXpathFormPage,
+      media_test_page:       MediaTestPage,
+      indexed_sections_page: IndexedSectionsPage,
+      custom_controls_page:  CustomControlsPage
+    }
+  end
+end
+
+
+World(WorldPages)

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

@@ -71,6 +71,7 @@ module TestCentricity
     @screen_shots = []
 
     attr_accessor :test_environment
+    attr_accessor :app_host
     attr_accessor :browser
     attr_accessor :browser_size
     attr_accessor :headless
@@ -133,9 +134,20 @@ module TestCentricity
       @db_username   = data['DB_USERNAME']
       @db_password   = data['DB_PASSWORD']
 
+      url = @hostname.blank? ? "#{@base_url}#{@append}" : "#{@hostname}/#{@base_url}#{@append}"
+      @app_host = if @user_id.blank? || @password.blank?
+                    "#{@protocol}://#{url}"
+                  else
+                    "#{@protocol}://#{@user_id}:#{@password}@#{url}"
+                  end
+
       super
     end
 
+    def self.app_host
+      @app_host
+    end
+
     def self.session_code
       if @session_code.nil?
         characters = ('a'..'z').to_a
@@ -328,6 +340,10 @@ module TestCentricity
       @platform = platform
     end
 
+    def self.platform
+      @platform
+    end
+
     def self.is_mobile?
       @platform == :mobile
     end
@@ -380,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"
@@ -395,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.5'
+  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_object.rb

@@ -1,5 +1,9 @@
 module TestCentricity
   class PageObject < BasePageSectionObject
+    def initialize
+      set_locator_type(page_locator) if defined?(page_locator)
+    end
+
     # Declare and instantiate a single generic UI Element for this page object.
     #
     # @param element_name [Symbol] name of UI object (as a symbol)
@@ -308,19 +312,15 @@ module TestCentricity
     end
 
     def open_portal
-      environment = Environ.current
-      url = environment.hostname.blank? ? "#{environment.base_url}#{environment.append}" : "#{environment.hostname}/#{environment.base_url}#{environment.append}"
-      if environment.user_id.blank? || environment.password.blank?
-        visit "#{environment.protocol}://#{url}"
-      else
-        visit "#{environment.protocol}://#{environment.user_id}:#{environment.password}@#{url}"
-      end
+      visit Environ.current.app_host
       Environ.portal_state = :open
     end
 
     def verify_page_exists
       raise "Page object #{self.class.name} does not have a page_locator trait defined" unless defined?(page_locator)
-      unless page.has_selector?(page_locator)
+
+      set_locator_type(page_locator) if @locator_type.blank?
+      unless page.has_selector?(@locator_type, page_locator)
         body_class = find(:xpath, '//body')[:class]
         error_message = %(
           Expected page to have selector '#{page_locator}' but found '#{body_class}' instead.

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
@@ -43,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
@@ -63,6 +87,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 +267,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 +314,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 %w[color number].include?(data_field.get_attribute(:type))
+                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