testcentricity_web 4.1.6 → 4.1.9

data/features/support/pages/indexed_sections_page.rb

@@ -0,0 +1,57 @@
+# Page Object class definition for Indexed Sections page with CSS locators
+
+class IndexedSectionsPage < BaseTestPage
+  trait(:page_name)    { 'Indexed Sections' }
+  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'}
+
+  list    :product_list, 'div#product_list'
+  section :product_card, ProductCard
+
+  def initialize
+    super
+    # define the list item element for the Product list object
+    list_elements = { list_item: 'div.column' }
+    product_list.define_list_elements(list_elements)
+    # associate the Product Card indexed section object with the Product list object
+    product_card.set_list_index(product_list)
+  end
+
+  def verify_page_ui
+    super
+
+    ui = {
+      product_list => {
+        exists: true,
+        visible: true,
+        itemcount: 4
+      },
+      product_card => { items: ['Tailored Jeans', 'Faded Short Sleeve T-shirts', 'Print Dress', 'Blouse'] }
+    }
+    verify_ui_states(ui)
+    # verify contents of first product card
+    product_card.set_list_index(product_list, 1)
+    card_data = {
+      product_name: 'Tailored Jeans',
+      price: '$59.99',
+      description: 'Some text about the jeans. Super slim and comfy lorem ipsum lorem jeansum. Lorem jeamsun denim lorem jeansum.',
+      rating: 3,
+      image_alt: 'Denim Jeans',
+      image_src: 'images/jeans3.jpg'
+    }
+    product_card.verify_card(card_data)
+    # verify contents of second product card
+    product_card.set_list_index(product_list, 2)
+    card_data = {
+      product_name: 'Faded Short Sleeve T-shirts',
+      price: '$19.99',
+      description: "Faded short sleeve t-shirt with high neckline. Soft and stretchy material for a comfortable fit. Accessorize with a straw hat and you're ready for summer!",
+      rating: 4,
+      image_alt: 'Faded Short Sleeve T-shirts',
+      image_src: 'images/T-shirt.jpg'
+    }
+    product_card.verify_card(card_data)
+  end
+end

data/features/support/pages/media_test_page.rb

@@ -0,0 +1,207 @@
+# 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, 20)
+    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: ''
+      }
+    }
+    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,
+        seeking: false,
+        current_time: { greater_than: 0 }
+      }
+    }
+    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,
+        seeking: false,
+        current_time: { greater_than: 0 }
+      }
+    }
+    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, 20)
+    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(2)
+  end
+end

data/features/support/sections/header_nav.rb

@@ -0,0 +1,48 @@
+# 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
+    self.wait_until_visible(5)
+    ui = {
+      self => {
+        exists: true,
+        visible: true,
+        hidden: false,
+        displayed: true,
+        enabled: true,
+        disabled: false,
+        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/sections/product_card.rb

@@ -0,0 +1,39 @@
+# Section Object class definition for Product Card
+
+class ProductCard < TestCentricity::PageSection
+  trait(:section_locator) { 'div.column' }
+  trait(:section_name)    { 'Product Card' }
+
+  # Product Card UI elements
+  image    :product_image,      "img[data-test-id='product_image']"
+  labels   name_label:          "h1[data-test-id='product_name']",
+           price_label:         "p[data-test-id='price']",
+           description_label:   "p[data-test-id='description']"
+  elements ratings:             "div[data-test-id='rating']",
+           checked_star:        'span.fa.fa-star.checked'
+  button   :add_to_cart_button, "button[data-test-id='add_to_cart']"
+
+  def get_value
+    name_label.get_caption
+  end
+
+  def verify_card(card_data)
+    ui = {
+      product_image => {
+        visible: true,
+        loaded: true,
+        broken: false,
+        src: { ends_with: card_data[:image_src] },
+        alt: card_data[:image_alt]
+      },
+      name_label         => { visible: true, caption: card_data[:product_name] },
+      price_label        => { visible: true, caption: card_data[:price] },
+      description_label  => { visible: true, caption: card_data[:description] },
+      checked_star       => { count: card_data[:rating] },
+      add_to_cart_button => { visible: true, enabled: true, caption: 'Add to Cart' }
+    }
+    within(self.get_locator) do
+      verify_ui_states(ui)
+    end
+  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

@@ -5,8 +5,11 @@ 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
     }
   end
 end

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/browser_helper.rb

@@ -95,12 +95,6 @@ module TestCentricity
       Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
     end
 
-    def self.close_named_browser_instance(name)
-      Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.find_window(name))
-      Capybara.page.driver.browser.close
-      Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
-    end
-
     def self.suppress_js_alerts
       Capybara.page.execute_script('window.alert = function() {}')
     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
@@ -384,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"
@@ -399,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.6'
+  VERSION = '4.1.9'
 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

@@ -312,14 +312,7 @@ 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}"
-      full_url = if environment.user_id.blank? || environment.password.blank?
-                   "#{environment.protocol}://#{url}"
-                 else
-                   "#{environment.protocol}://#{environment.user_id}:#{environment.password}@#{url}"
-                 end
-      visit full_url
+      visit Environ.current.app_host
       Environ.portal_state = :open
     end