testcentricity_web 0.6.5 → 0.6.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: efa2ac57acd9db62cb902913e7b5d01f2fc0da1c
-  data.tar.gz: fdc2c928d12c6d36deb09479097f1ed503e6bdca
+  metadata.gz: e3a4df3b5ec1ff539aa075b22f539bfad13343ae
+  data.tar.gz: cb44ead5d3e54df4474f17d79452949ed21b7ca1
 SHA512:
-  metadata.gz: 80070a049f3ebe5bff203c2778d615cadd5a54de75d40e8efb7ec6d6be8cc3ac0a3714ab52db6be88228996554a6a2e68bc7ae141fe1303238b36c0e54733a86
-  data.tar.gz: 056732a64b5a80bbc88d4437424c260a951756ab83c2c257f6b1447d2d44289e247c3f2815c670950321c6b30eec09b2b59ad591dcb93fd31dce702a17895554
+  metadata.gz: 4a7f722564956db3ea58c2abe9cbb0ea5eafba23aa557a3004730a6938c41f73b389419bbe54f8c6818167d8b281aee18e7ec72a2d5dd3ddb8159defa24ada65
+  data.tar.gz: eaf26e88a4fceb2242f79d835e13131809504d3d9009857f95c71cdcbe32b7778a7067f2f8e29f94a08fd3eda3603e043db28a6403e2dc2889121d5bba94695b

data/README.md

@@ -120,11 +120,11 @@ You define your page's **Traits** as shown below:
       trait(:page_locator)    { "//body[@class='login-body']" }
     
       # Login page UI elements
-      textfield :user_id_field,        "userName"
-      textfield :password_field,       "password"
-      button    :login_button,         "//input[@id='submit_button']"
-      checkbox  :remember_checkbox,    "rememberUser']"
-      label     :error_message_label,  'div#statusBar.login-error'
+      textfield :user_id_field,       "userName"
+      textfield :password_field,      "password"
+      button    :login_button,        "//input[@id='submit_button']"
+      checkbox  :remember_checkbox,   "rememberUser']"
+      label     :error_message_label, 'div#statusBar.login-error'
     end
     
 Once your **Page Objects** have been instantiated, you can interact with the **UI Elements** in your **Page Objects**. An example is shown
@@ -147,11 +147,11 @@ the UI to hide implementation details, as shown below:
       trait(:page_locator)    { "//body[@class='login-body']" }
     
       # Login page UI elements
-      textfield :user_id_field,        "userName"
-      textfield :password_field,       "password"
-      button    :login_button,         "//input[@id='submit_button']"
-      checkbox  :remember_checkbox,    "rememberUser']"
-      label     :error_message_label,  'div#statusBar.login-error'
+      textfield :user_id_field,       "userName"
+      textfield :password_field,      "password"
+      button    :login_button,        "//input[@id='submit_button']"
+      checkbox  :remember_checkbox,   "rememberUser']"
+      label     :error_message_label, 'div#statusBar.login-error'
     
       def login(user_id, password)
         user_id_field.set(user_id)
@@ -198,7 +198,7 @@ specifies the CSS or Xpath expression that uniquely identifies that root node ob
 You define your page section's **Traits** as shown below:
 
     class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)    { "//form[@id='gnav-search']" }
+      trait(:section_locator)   { "//form[@id='gnav-search']" }
     end
 
 
@@ -207,11 +207,11 @@ You define your page section's **Traits** as shown below:
 **UI Elements** are added to your **PageSection** class definition as shown below:
 
     class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)    { "//form[@id='gnav-search']" }
+      trait(:section_locator)   { "//form[@id='gnav-search']" }
         
       # Search Form UI elements
-      textfield :search_field,   "//input[@id='search-query']"
-      button    :search_button,  "//button[@type='submit']"
+      textfield :search_field,  "//input[@id='search-query']"
+      button    :search_button, "//button[@type='submit']"
     end
 
 
@@ -220,11 +220,11 @@ You define your page section's **Traits** as shown below:
 You can add high level methods to your **PageSection** class definition, as shown below:
 
     class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)    { "//form[@id='gnav-search']" }
+      trait(:section_locator)   { "//form[@id='gnav-search']" }
         
       # Search Form UI elements
-      textfield :search_field,   "//input[@id='search-query']"
-      button    :search_button,  "//button[@type='submit']"
+      textfield :search_field,  "//input[@id='search-query']"
+      button    :search_button, "//button[@type='submit']"
 
       def search_for(value)
         search_field.set(value)
@@ -290,17 +290,17 @@ to be instantiated by **PageManager**:
     
     module WorldPages
       def page_objects
-        { :login_page                 => LoginPage,
-          :home_page                  => HomePage,
-          :registration_page          => RegistrationPage,
-          :products_grid_page         => ProductsCollectionPage,
-          :product_detail_page        => ProductDetailPage,
-          :shopping_basket_page       => ShoppingBasketPage,
-          :payment_method_page        => PaymentMethodPage,
-          :confirm_purchase_page      => PurchaseConfirmationPage,
-          :my_account_page            => MyAccountPage,
-          :my_order_history_page      => MyOrderHistoryPage,
-          :my_ship_to_addresses_page  => MyShipToAddressesPage
+        { :login_page                => LoginPage,
+          :home_page                 => HomePage,
+          :registration_page         => RegistrationPage,
+          :products_grid_page        => ProductsCollectionPage,
+          :product_detail_page       => ProductDetailPage,
+          :shopping_basket_page      => ShoppingBasketPage,
+          :payment_method_page       => PaymentMethodPage,
+          :confirm_purchase_page     => PurchaseConfirmationPage,
+          :my_account_page           => MyAccountPage,
+          :my_order_history_page     => MyOrderHistoryPage,
+          :my_ship_to_addresses_page => MyShipToAddressesPage
         }
       end
     end

data/lib/testcentricity_web.rb

@@ -1,6 +1,7 @@
 require 'capybara/cucumber'
 require 'test/unit'
 require 'capybara/poltergeist'
+
 require 'testcentricity_web/world_extensions'
 require 'testcentricity_web/browser_helper'
 require 'testcentricity_web/data_objects_helper'

data/lib/testcentricity_web/elements/button.rb

@@ -0,0 +1,11 @@
+module TestCentricity
+  class Button < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :button
+      @alt_locator = nil
+    end
+  end
+end

data/lib/testcentricity_web/elements/checkbox.rb

@@ -0,0 +1,44 @@
+module TestCentricity
+  class CheckBox < UIElement
+
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :checkbox
+      @alt_locator = nil
+    end
+
+    # Is checkbox checked?
+    #
+    # @return [Boolean]
+    # @example
+    #   remember_me_checkbox.checked?
+    #
+    def checked?
+      obj, _ = find_element
+      object_not_found_exception(obj, 'Checkbox')
+      obj.checked?
+    end
+
+    # Set the check state of a checkbox object.
+    #
+    # @param state [Boolean] true = checked / false = unchecked
+    # @example
+    #   remember_me_checkbox.set_checkbox_state(true)
+    #
+    def set_checkbox_state(state)
+      obj, _ = find_element
+      object_not_found_exception(obj, 'Checkbox')
+      invalid_object_type_exception(obj, 'checkbox')
+      obj.set(state)
+    end
+
+    def verify_check_state(state, enqueue = false)
+      actual = checked?
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(state, actual, "Expected #{@locator}") :
+          assert_equal(state, actual, "Expected #{@locator} to be #{state} but found #{actual} instead")
+    end
+  end
+end

data/lib/testcentricity_web/elements/file_field.rb

@@ -0,0 +1,17 @@
+module TestCentricity
+  class FileField < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :filefield
+      @alt_locator = nil
+    end
+
+    def attach_file(file_path)
+      Capybara.ignore_hidden_elements = false
+      page.attach_file(@locator, file_path)
+      Capybara.ignore_hidden_elements = true
+    end
+  end
+end

data/lib/testcentricity_web/elements/image.rb

@@ -0,0 +1,11 @@
+module TestCentricity
+  class Image < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :image
+      @alt_locator = nil
+    end
+  end
+end

data/lib/testcentricity_web/elements/label.rb

@@ -0,0 +1,11 @@
+module TestCentricity
+  class Label < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :label
+      @alt_locator = nil
+    end
+  end
+end

data/lib/testcentricity_web/elements/link.rb

@@ -0,0 +1,11 @@
+module TestCentricity
+  class Link < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :link
+      @alt_locator = nil
+    end
+  end
+end

data/lib/testcentricity_web/elements/select_list.rb

@@ -0,0 +1,82 @@
+module TestCentricity
+  class SelectList < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :selectlist
+      @alt_locator = nil
+    end
+
+    # Select the specified option in a select box object.
+    # Supports standard HTML select objects and Chosen select objects.
+    #
+    # @param option [String] text of option to select
+    # @example
+    #   province_select.choose_option('Nova Scotia')
+    #
+    def choose_option(option)
+      obj, _ = find_element
+      object_not_found_exception(obj, nil)
+      obj.click
+      if first(:css, 'li.active-result')
+        if option.is_a?(Array)
+          option.each do |item|
+            page.find(:css, 'li.active-result', text: item.strip).click
+          end
+        else
+          first(:css, 'li.active-result', text: option).click
+        end
+      else
+        if option.is_a?(Array)
+          option.each do |item|
+            obj.select item
+          end
+        else
+          obj.select option
+        end
+      end
+    end
+
+    # Return array of strings of all options in a select box object.
+    # Supports standard HTML select objects and Chosen select objects.
+    #
+    # @return [Array]
+    # @example
+    #   all_colors = color_select.get_options
+    #
+    def get_options
+      obj, _ = find_element
+      object_not_found_exception(obj, nil)
+      if first(:css, 'li.active-result')
+        obj.all('li.active-result').collect(&:text)
+      else
+        obj.all('option').collect(&:text)
+      end
+    end
+
+    def verify_options(expected, enqueue = false)
+      actual = get_options
+      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}")
+    end
+
+    # Return text of first selected option in a select box object.
+    # Supports standard HTML select objects and Chosen select objects.
+    #
+    # @return [String]
+    # @example
+    #   current_color = color_select.get_selected_option
+    #
+    def get_selected_option
+      obj, _ = find_element
+      object_not_found_exception(obj, nil)
+      if first(:css, 'li.active-result')
+        obj.first("//li[contains(@class, 'result-selected')]").text
+      else
+        obj.first('option[selected]').text
+      end
+    end
+  end
+end

data/lib/testcentricity_web/elements/table.rb

@@ -0,0 +1,264 @@
+module TestCentricity
+  class Table < UIElement
+    def initialize(parent, locator, context)
+      @parent  = parent
+      @locator = locator
+      @context = context
+      @type    = :table
+      @alt_locator = nil
+    end
+
+    # Return number of rows in a table object.
+    #
+    # @return [Integer]
+    # @example
+    #   num_rows = list_table.get_row_count
+    #
+    def get_row_count
+      wait_until_exists(5)
+      row_count = page.all(:xpath, "#{@locator}/tbody/tr", :visible => :all).count
+      row_count
+    end
+
+    # Return number of columns in a table object.
+    #
+    # @return [Integer]
+    # @example
+    #   num_columns = list_table.get_column_count
+    #
+    def get_column_count
+      row_count = get_row_count
+      if row_count == 0
+        page.all(:xpath, "#{@locator}/thead/tr/th", :visible => :all).count
+      else
+        (row_count == 1) ?
+            page.all(:xpath, "#{@locator}/tbody/tr/td", :visible => :all).count :
+            page.all(:xpath, "#{@locator}/tbody/tr[2]/td", :visible => :all).count
+      end
+    end
+
+    # Click in the specified cell in a table object.
+    #
+    # @param row [Integer] row number
+    # @param column [Integer] column number
+    # @example
+    #   list_table.click_table_cell(3, 5)
+    #
+    def click_table_cell(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)
+      click
+      clear_alt_locator
+    end
+
+    # Double-click in the specified cell in a table object.
+    #
+    # @param row [Integer] row number
+    # @param column [Integer] column number
+    # @example
+    #   list_table.double_click_table_cell(3, 5)
+    #
+    def double_click_table_cell(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)
+      double_click
+      clear_alt_locator
+    end
+
+    # Click the link object embedded within the specified cell in a table object.
+    #
+    # @param row [Integer] row number
+    # @param column [Integer] column number
+    # @example
+    #   list_table.click_table_cell_link(3, 1)
+    #
+    def click_table_cell_link(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)
+      saved_locator = @alt_locator
+      set_alt_locator("#{@alt_locator}/a")
+      set_alt_locator("#{saved_locator}/span/a") unless exists?
+      # if link not present, check for text entry fields and try to dismiss by tabbing out
+      unless exists?
+        set_alt_locator("#{saved_locator}/input")
+        set_alt_locator("#{saved_locator}/textarea") unless exists?
+        send_keys(:tab) if exists?
+        set_alt_locator("#{saved_locator}/a")
+        set_alt_locator("#{saved_locator}/span/a") unless exists?
+        send_keys(:tab) unless exists?
+      end
+      wait_until_exists(1)
+      click
+      clear_alt_locator
+    end
+
+    def get_table_row(row)
+      columns = []
+      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
+      (1..column_count).each do |column|
+        value = ''
+        set_table_cell_locator(row, column)
+        saved_locator = @alt_locator
+        set_alt_locator("#{saved_locator}/input")
+        unless exists?
+          set_alt_locator("#{saved_locator}/textarea")
+          unless exists?
+            set_alt_locator(saved_locator)
+          end
+        end
+        value = get_value if exists?
+        columns.push(value)
+      end
+      clear_alt_locator
+      columns
+    end
+
+    def get_row_data(row)
+      row_count = get_row_count
+      raise "Row #{row} exceeds number of rows (#{row_count}) in table #{@locator}" if row > row_count
+      (row > 1) ?
+          set_alt_locator("#{@locator}/tbody/tr[#{row}]") :
+          set_alt_locator("#{@locator}/tbody/tr")
+      value = get_value if exists?
+      clear_alt_locator
+      value
+    end
+
+    # Return text contained in specified cell of a table object.
+    #
+    # @param row [Integer] row number
+    # @param column [Integer] column number
+    # @return [String] value of table cell
+    # @example
+    #   list_table.get_table_cell(4, 5)
+    #
+    def get_table_cell(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)
+      saved_locator = @alt_locator
+      set_alt_locator("#{saved_locator}/input")
+      unless exists?
+        set_alt_locator("#{saved_locator}/textarea")
+        unless exists?
+          set_alt_locator(saved_locator)
+        end
+      end
+      value = get_value if exists?
+      clear_alt_locator
+      value
+    end
+
+    def verify_table_cell(row, column, expected, enqueue = false)
+      actual = get_table_cell(row, column)
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(expected.strip, actual.strip, "Expected #{@locator} row #{row}/column #{column}") :
+          assert_equal(expected.strip, actual.strip, "Expected #{@locator} row #{row}/column #{column} to display '#{expected}' but found '#{actual}'")
+    end
+
+    # Set the value of the specified cell in a table object.
+    #
+    # @param row [Integer] row number
+    # @param column [Integer] column number
+    # @param value [String] text to set
+    # @example
+    #   list_table.set_table_cell(3, 1, 'Ontario')
+    #
+    def set_table_cell(row, column, value)
+      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)
+      click if exists?
+      saved_locator = @alt_locator
+      set_alt_locator("#{saved_locator}/input")
+      set_alt_locator("#{saved_locator}/textarea") unless exists?
+      set(value)
+      clear_alt_locator
+    end
+
+    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
+      end
+      nil
+    end
+
+    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
+      end
+      nil
+    end
+
+    def populate_table_row(row, data)
+      wait_until_exists(2)
+      data.each do | column, data_param |
+        unless data_param.blank?
+          if data_param == '!DELETE'
+            set_table_cell(row, column, '')
+          else
+            set_table_cell(row, column, data_param)
+          end
+        end
+      end
+    end
+
+    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
+      (column > 1) ?
+          set_alt_locator("#{@locator}/thead/tr/th[#{column}]") :
+          set_alt_locator("#{@locator}/thead/tr/th")
+      click
+      clear_alt_locator
+    end
+
+    def get_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
+      (column > 1) ?
+          set_alt_locator("#{@locator}/thead/tr/th[#{column}]") :
+          set_alt_locator("#{@locator}/thead/tr/th")
+      value = get_value
+      clear_alt_locator
+      value
+    end
+
+    def get_header_columns
+      columns = []
+      column_count = get_column_count
+      (1..column_count).each do |column|
+        (column > 1) ?
+            set_alt_locator("#{@locator}/thead/tr/th[#{column}]") :
+            set_alt_locator("#{@locator}/thead/tr/th")
+        columns.push(get_value)
+      end
+      clear_alt_locator
+      columns
+    end
+
+    private
+
+    def set_table_cell_locator(row, column)
+      row_spec = "#{@locator}/tbody/tr"
+      row_spec = "#{row_spec}[#{row}]" if row > 1
+      column_spec = "/td[#{column}]"
+      set_alt_locator("#{row_spec}#{column_spec}")
+    end
+  end
+end