testcentricity_web 0.6.6.1 → 0.6.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 332bd85d16deb74c0440f905478487e3eeaabdad
-  data.tar.gz: 3dde903f9054a2a51d6d29adae3487c7918378e3
+  metadata.gz: f6b35ced39b5ac4d97276a251e1a27b7ee1a9efd
+  data.tar.gz: 337a5c09b14e9afd16d2597ab38fea8b67ac4278
 SHA512:
-  metadata.gz: 23bde7975f1539df36d43507811e4326ce74a7cf24bb4d6f356e7aac89a748d3fd96a0d420b8462f124328f66e8cb89790bd8abef58d19408ef9e072ce708ef8
-  data.tar.gz: a608963409b74d36587543f69bb6990c670cc8ff00bd317f9042eacabc0c0c1bd663c7702298053b95118240193f3a936ea356fed0081fa5e753621ddf3330b7
+  metadata.gz: 7cfc198f368d3884d069786a4712fb1161af583b1003fb0c544fd8561b0ef1ef7f412508affb75a8a9a55a2f212ab972e1f637a84a9fa757f59e8eb8eb449caf
+  data.tar.gz: 2b91285c7b93ceea60223140e98faa4885ef7e7fdf994be924f0f8250ac41f57324f53f303c992c9668a45b0c916bdc3dca237c96b7a41d27f08f147583b0da5

data/README.md

@@ -1,9 +1,13 @@
 # TestCentricityWeb
 
 The TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object and Data Object Model DSL for
-use with Cucumber, Capybara, and Selenium-Webdriver. It supports testing against locally hosted desktop browsers (Firefox, Chrome, Safari,
-IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox), a "headless" browser (using Poltergeist and PhantomJS),
-or on cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
+use with Cucumber, Capybara, and Selenium-Webdriver.
+
+The TestCentricity™ web gem supports running testing against the following web test targets:
+* locally hosted desktop browsers (Firefox, Chrome, Safari, IE, or Edge)
+* locally hosted emulated iOS and Android mobile browsers (using Firefox)
+* a "headless" browser (using Poltergeist and PhantomJS)
+* cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
 
 
 ## Installation
@@ -28,20 +32,18 @@ If you are using Cucumber, you need to require the following in your *env.rb* fi
 
     require 'capybara'
     require 'capybara/cucumber'
-    require 'selenium-webdriver'
     require 'testcentricity_web'
-    
-    
+
+
 ###Using RSpec
 
 If you are using RSpec instead, you need to require the following in your *env.rb* file:
 
     require 'capybara'
     require 'capybara/rspec'
-    require 'selenium-webdriver'
     require 'testcentricity_web'
-    
-    
+
+
 ### Using Poltergeist
 
 If you will be running your tests on a "headless" web browser using Poltergeist and PhantomJS, you must add this line to your automation

data/lib/testcentricity_web.rb

@@ -17,6 +17,16 @@ require 'testcentricity_web/environment'
 require 'testcentricity_web/webdriver_helper'
 require 'testcentricity_web/version'
 
+require 'testcentricity_web/elements/button'
+require 'testcentricity_web/elements/checkbox'
+require 'testcentricity_web/elements/file_field'
+require 'testcentricity_web/elements/image'
+require 'testcentricity_web/elements/label'
+require 'testcentricity_web/elements/link'
+require 'testcentricity_web/elements/select_list'
+require 'testcentricity_web/elements/table'
+require 'testcentricity_web/elements/textfield'
+
 
 module TestCentricity
   class PageManager

data/lib/testcentricity_web/browser_helper.rb

@@ -112,6 +112,7 @@ module TestCentricity
                   :ipad_pro         => "Mozilla/5.0 (iPad; CPU OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B137 Safari/601.1",
                   :android_phone    => "Mozilla/5.0 (Linux; U; Android 4.0.1; en-us; sdk Build/ICS_MR0) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30",
                   :android_tablet   => "Mozilla/5.0 (Linux; U; Android 3.0; en-us; GT-P7100 Build/HRI83) AppleWebkit/534.13 (KHTML, like Gecko) Version/4.0 Safari/534.13",
+                  :windows_phone10  => "Mozilla/5.0 (Windows Phone 10.0; Android 4.2.1; DEVICE INFO) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.71 Mobile Safari/537.36 Edge/12.0",
                   :windows_phone8   => "Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 920)",
                   :windows_phone7   => "Mozilla/5.0 (compatible; MSIE 9.0; Windows Phone OS 7.5; Trident/5.0; IEMobile/9.0; NOKIA; Lumia 710)"
       }

data/lib/testcentricity_web/elements/checkbox.rb

@@ -40,5 +40,19 @@ module TestCentricity
           ExceptionQueue.enqueue_assert_equal(state, actual, "Expected #{@locator}") :
           assert_equal(state, actual, "Expected #{@locator} to be #{state} but found #{actual} instead")
     end
+
+    # Set the check state of a Siebel OUI JCheckBox object.
+    #
+    # @param state [Boolean] true = checked / false = unchecked
+    # @example
+    #   remember_me_checkbox.set_siebel_checkbox_state(true)
+    #
+    def set_siebel_checkbox_state(state)
+      obj, _ = find_element
+      object_not_found_exception(obj, 'Siebel checkbox')
+      raise "#{locator} is not a Siebel CheckBox object" unless get_siebel_object_type == 'JCheckBox'
+      expected = state.to_bool
+      obj.click unless expected == obj.checked?
+    end
   end
 end

data/lib/testcentricity_web/elements/select_list.rb

@@ -78,5 +78,43 @@ module TestCentricity
         obj.first('option[selected]').text
       end
     end
+
+    # Select the specified option in a Siebel OUI select box object.
+    #
+    # @param option [String] text of option to select
+    # @example
+    #   country_select.choose_siebel_option('Cayman Islands')
+    #
+    def choose_siebel_option(option)
+      Capybara.wait_on_first_by_default = true
+      invoke_siebel_popup
+      first(:xpath, "//li[@class='ui-menu-item']", :exact => true, :match => :prefer_exact,text: option).click
+    end
+
+    # Return array of strings of all options in a Siebel OUI select box object.
+    #
+    # @return [Array]
+    # @example
+    #   all_countries = country_select.get_siebel_options
+    #
+    def get_siebel_options
+      invoke_siebel_popup
+      sleep(0.5)
+      options = page.all(:xpath, "//li[@class='ui-menu-item']").collect(&:text)
+      obj, _ = find_element
+      obj.native.send_keys(:escape)
+      options
+    end
+
+    def verify_siebel_options(expected, enqueue = false)
+      invoke_siebel_popup
+      sleep(0.5)
+      actual = page.all(:xpath, "//li[@class='ui-menu-item']").collect(&:text)
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected list of options in list #{@locator}") :
+          assert_equal(expected, actual, "Expected list of options in list #{@locator} to be #{expected} but found #{actual}")
+      obj, _ = find_element
+      obj.native.send_keys(:escape)
+    end
   end
 end

data/lib/testcentricity_web/elements/table.rb

@@ -191,6 +191,15 @@ module TestCentricity
       clear_alt_locator
     end
 
+    # Search for the specified text value in the specified row of the table object.
+    # Returns the number of the first column that contains the search value.
+    #
+    # @param row [Integer] row nummber
+    # @param search_value [String] value to be searched for
+    # @return [Integer] column number of table cell that contains search value
+    # @example
+    #   list_table.find_in_table_row(4, 'High speed Framus bolts')
+    #
     def find_in_table_row(row, search_value)
       (1..get_column_count).each do |column|
         return column if get_table_cell(row, column) == search_value
@@ -198,6 +207,15 @@ module TestCentricity
       nil
     end
 
+    # Search for the specified text value in the specified column of the table object.
+    # Returns the number of the first row that contains the search value.
+    #
+    # @param column [Integer] column nummber
+    # @param search_value [String] value to be searched for
+    # @return [Integer] row number of table cell that contains search value
+    # @example
+    #   list_table.find_in_table_column(1, 'Ashes to Ashes')
+    #
     def find_in_table_column(column, search_value)
       (1..get_row_count).each do |row|
         return row if get_table_cell(row, column) == search_value
@@ -205,6 +223,21 @@ module TestCentricity
       nil
     end
 
+    # Populate the specified row of this table 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 select list 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)
+    #
+    # @param data [Hash] column numbers and associated data to be entered
+    # @example
+    #   data = { 1 => 'Dr.',
+    #            2 => 'Evangeline',
+    #            3 => 'Devereaux',
+    #            4 => 'MD',
+    #            5 => 'Family Practice'
+    #          }
+    #   clinician_table.populate_table_row(3, data)
+    #
     def populate_table_row(row, data)
       wait_until_exists(2)
       data.each do | column, data_param |
@@ -218,6 +251,12 @@ module TestCentricity
       end
     end
 
+    # Click in the specified column header in a table object.
+    #
+    # @param column [Integer] column number
+    # @example
+    #   list_table.click_header_column(3)
+    #
     def click_header_column(column)
       column_count = get_column_count
       raise "Column #{column} exceeds number of columns (#{column_count}) in table header #{@locator}" if column > column_count
@@ -252,6 +291,47 @@ module TestCentricity
       columns
     end
 
+
+    def is_table_row_expanded?(row, column)
+      row_count = get_row_count
+      raise "Row #{row} exceeds number of rows (#{row_count}) in table #{@locator}" if row > row_count
+      column_count = get_column_count
+      raise "Column #{column} exceeds number of columns (#{column_count}) in table #{@locator}" if column > column_count
+      set_table_cell_locator(row, column)
+      set_alt_locator("#{@alt_locator}/div/div[contains(@class, 'tree-plus treeclick')]")
+      expanded = true
+      expanded = false if exists?
+      clear_alt_locator
+      expanded
+    end
+
+    def expand_table_row(row, column)
+      unless is_table_row_expanded?(row, column)
+        set_table_cell_locator(row, column)
+        set_alt_locator("#{@alt_locator}/div/div[contains(@class, 'tree-plus treeclick')]")
+        click if exists?
+        clear_alt_locator
+      end
+    end
+
+    def collapse_table_row(row, column)
+      if is_table_row_expanded?(row, column)
+        set_table_cell_locator(row, column)
+        set_alt_locator("#{@alt_locator}/div/div[contains(@class, 'tree-minus treeclick')]")
+        click if exists?
+        clear_alt_locator
+      end
+    end
+
+    def expand_all_table_rows(column)
+      row_count = get_row_count
+      column_count = get_column_count
+      raise "Column #{column} exceeds number of columns (#{column_count}) in table #{@locator}" if column > column_count
+      row_count.downto(1) do |row|
+        expand_table_row(row, column)
+      end
+    end
+
     private
 
     def set_table_cell_locator(row, column)

data/lib/testcentricity_web/siebel_open_ui_helper.rb

@@ -1,117 +1,14 @@
 module TestCentricity
   class UIElement
-    # Set the check state of a Siebel OUI JCheckBox object.
-    #
-    # @param state [Boolean] true = checked / false = unchecked
-    # @example
-    #   remember_me_checkbox.set_siebel_checkbox_state(true)
-    #
-    def set_siebel_checkbox_state(state)
-      obj, _ = find_element
-      object_not_found_exception(obj, 'Siebel checkbox')
-      raise "#{locator} is not a Siebel CheckBox object" unless get_siebel_object_type == 'JCheckBox'
-      expected = state.to_bool
-      obj.click unless expected == obj.checked?
-    end
-
-    # Select the specified option in a Siebel OUI select box object.
-    #
-    # @param option [String] text of option to select
-    # @example
-    #   country_select.choose_siebel_option('Cayman Islands')
-    #
-    def choose_siebel_option(option)
-      Capybara.wait_on_first_by_default = true
-      invoke_siebel_popup
-      first(:xpath, "//li[@class='ui-menu-item']", :exact => true, :match => :prefer_exact,text: option).click
-    end
-
-    # Return array of strings of all options in a Siebel OUI select box object.
-    #
-    # @return [Array]
-    # @example
-    #   all_countries = country_select.get_siebel_options
-    #
-    def get_siebel_options
-      invoke_siebel_popup
-      sleep(0.5)
-      options = page.all(:xpath, "//li[@class='ui-menu-item']").collect(&:text)
-      obj, _ = find_element
-      obj.native.send_keys(:escape)
-      options
-    end
-
-    def verify_siebel_options(expected, enqueue = false)
-      invoke_siebel_popup
-      sleep(0.5)
-      actual = page.all(:xpath, "//li[@class='ui-menu-item']").collect(&:text)
-      enqueue ?
-          ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected list of options in list #{@locator}") :
-          assert_equal(expected, actual, "Expected list of options in list #{@locator} to be #{expected} but found #{actual}")
-      obj, _ = find_element
-      obj.native.send_keys(:escape)
-    end
-
     def invoke_siebel_dialog(popup)
       invoke_siebel_popup
       popup.wait_until_exists(15)
     end
 
-    def is_table_row_expanded?(row, column)
-      row_count = get_row_count
-      raise "Row #{row} exceeds number of rows (#{row_count}) in table #{@locator}" if row > row_count
-      column_count = get_column_count
-      raise "Column #{column} exceeds number of columns (#{column_count}) in table #{@locator}" if column > column_count
-      set_table_cell_locator(row, column)
-      set_alt_locator("#{@alt_locator}/div/div[contains(@class, 'tree-plus treeclick')]")
-      expanded = true
-      expanded = false if exists?
-      clear_alt_locator
-      expanded
-    end
-
-    def expand_table_row(row, column)
-      unless is_table_row_expanded?(row, column)
-        set_table_cell_locator(row, column)
-        set_alt_locator("#{@alt_locator}/div/div[contains(@class, 'tree-plus treeclick')]")
-        click if exists?
-        clear_alt_locator
-      end
-    end
-
-    def collapse_table_row(row, column)
-      if is_table_row_expanded?(row, column)
-        set_table_cell_locator(row, column)
-        set_alt_locator("#{@alt_locator}/div/div[contains(@class, 'tree-minus treeclick')]")
-        click if exists?
-        clear_alt_locator
-      end
-    end
-
-    def expand_all_table_rows(column)
-      row_count = get_row_count
-      column_count = get_column_count
-      raise "Column #{column} exceeds number of columns (#{column_count}) in table #{@locator}" if column > column_count
-      row_count.downto(1) do |row|
-        expand_table_row(row, column)
-      end
-    end
-
     def get_siebel_object_type
       obj, _ = find_element
       object_not_found_exception(obj, 'Siebel object')
       obj.native.attribute('ot')
     end
-
-    private
-
-    def invoke_siebel_popup
-      obj, _ = find_element
-      object_not_found_exception(obj, 'Siebel object')
-      trigger_name = obj.native.attribute('aria-describedby').strip
-      trigger = "//span[@id='#{trigger_name}']"
-      trigger = "#{@parent.get_locator}#{trigger}" if @context == :section && !@parent.get_locator.nil?
-      first(:xpath, trigger).click
-    end
   end
 end

data/lib/testcentricity_web/ui_elements_helper.rb

@@ -313,15 +313,14 @@ module TestCentricity
         raise "#{locator} is not a #{obj_type} element"
       end
     end
+
+    def invoke_siebel_popup
+      obj, _ = find_element
+      object_not_found_exception(obj, 'Siebel object')
+      trigger_name = obj.native.attribute('aria-describedby').strip
+      trigger = "//span[@id='#{trigger_name}']"
+      trigger = "#{@parent.get_locator}#{trigger}" if @context == :section && !@parent.get_locator.nil?
+      first(:xpath, trigger).click
+    end
   end
 end
-
-require 'testcentricity_web/elements/button'
-require 'testcentricity_web/elements/checkbox'
-require 'testcentricity_web/elements/file_field'
-require 'testcentricity_web/elements/image'
-require 'testcentricity_web/elements/label'
-require 'testcentricity_web/elements/link'
-require 'testcentricity_web/elements/select_list'
-require 'testcentricity_web/elements/table'
-require 'testcentricity_web/elements/textfield'

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '0.6.6.1'
+  VERSION = '0.6.7'
 end

metadata

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