testcentricity_web 2.1.8.2 → 2.1.8.3

data/lib/testcentricity_web/data_objects_helper.rb

@@ -0,0 +1,78 @@
+require 'yaml'
+require 'json'
+
+
+module TestCentricity
+
+  XL_PRIMARY_DATA_PATH ||= 'features/test_data/'
+  XL_PRIMARY_DATA_FILE ||= "#{XL_PRIMARY_DATA_PATH}data.xls"
+
+
+  class DataObject
+    attr_accessor :current
+    attr_accessor :context
+    attr_accessor :hash_table
+
+    def initialize(data)
+      @hash_table = data
+    end
+
+    # @deprecated Please use {#current=} instead
+    def self.set_current(current)
+      warn "[DEPRECATION] 'TestCentricity::DataObject.set_current' is deprecated.  Please use 'current=' instead."
+      @current = current
+    end
+
+    def self.current
+      @current
+    end
+
+    def self.current=(current)
+      @current = current
+    end
+  end
+
+
+  class DataSource
+    attr_accessor :current
+
+    def read_yaml_node_data(file_name, node_name)
+      data = YAML.load_file("#{XL_PRIMARY_DATA_PATH}#{file_name}")
+      data[node_name]
+    end
+
+    def read_json_node_data(file_name, node_name)
+      raw_data = File.read("#{XL_PRIMARY_DATA_PATH}#{file_name}")
+      data = JSON.parse(raw_data)
+      data[node_name]
+    end
+  end
+
+
+  class ExcelDataSource < TestCentricity::DataSource
+    def pick_excel_data_source(sheet, row_spec)
+      if ENV['TEST_ENVIRONMENT']
+        environment = ENV['TEST_ENVIRONMENT']
+        data_file = "#{XL_PRIMARY_DATA_PATH}#{environment}_data.xls"
+        data_file = XL_PRIMARY_DATA_FILE unless ExcelData.rowspec_exists?(data_file, sheet, row_spec)
+      else
+        data_file = XL_PRIMARY_DATA_FILE
+      end
+      data_file
+    end
+
+    def read_excel_row_data(sheet, row_name, parallel = false)
+      parallel == :parallel && ENV['PARALLEL'] ? row_spec = "#{row_name}#{ENV['TEST_ENV_NUMBER']}" : row_spec = row_name
+      ExcelData.read_row_data(pick_excel_data_source(sheet, row_spec), sheet, row_spec)
+    end
+
+    def read_excel_pool_data(sheet, row_name, parallel = false)
+      parallel == :parallel && ENV['PARALLEL'] ? row_spec = "#{row_name}#{ENV['TEST_ENV_NUMBER']}" : row_spec = row_name
+      ExcelData.read_row_from_pool(pick_excel_data_source(sheet, row_name), sheet, row_spec)
+    end
+
+    def read_excel_range_data(sheet, range_name)
+      ExcelData.read_range_data(pick_excel_data_source(sheet, range_name), sheet, range_name)
+    end
+  end
+end

data/lib/testcentricity_web/drag_drop_helper.rb

@@ -0,0 +1,15 @@
+module CapybaraExtension
+  def drag_by(right_by, down_by)
+    base.drag_by(right_by, down_by)
+  end
+end
+
+
+module CapybaraSeleniumExtension
+  def drag_by(right_by, down_by)
+    driver.browser.action.drag_and_drop_by(native, right_by, down_by).perform
+  end
+end
+
+::Capybara::Selenium::Node.send :include, CapybaraSeleniumExtension
+::Capybara::Node::Element.send :include, CapybaraExtension

data/lib/testcentricity_web/elements/button.rb

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

data/lib/testcentricity_web/elements/cell_button.rb

@@ -0,0 +1,8 @@
+module TestCentricity
+  class CellButton < CellElement
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type = :cell_button
+    end
+  end
+end

data/lib/testcentricity_web/elements/cell_checkbox.rb

@@ -0,0 +1,38 @@
+module TestCentricity
+  class CellCheckBox < CellElement
+    attr_accessor :proxy
+
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type  = :cell_checkbox
+      @proxy = proxy
+    end
+
+    def checked?(row)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell CheckBox', row)
+      obj.checked?
+    end
+
+    def set_checkbox_state(row, state)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell CheckBox', row)
+      obj.set(state)
+    end
+
+    def check(row)
+      set_checkbox_state(row, true)
+    end
+
+    def uncheck(row)
+      set_checkbox_state(row, false)
+    end
+
+    def verify_check_state(row, state, enqueue = false)
+      actual = checked?(row)
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(state, actual, "Expected Row #{row}/Col #{@column} Cell Checkbox #{object_ref_message}") :
+          assert_equal(state, actual, "Expected Row #{row}/Col #{@column} Cell Checkbox #{object_ref_message} to be #{state} but found #{actual} instead")
+    end
+  end
+end

data/lib/testcentricity_web/elements/cell_element.rb

@@ -0,0 +1,62 @@
+module TestCentricity
+  class CellElement < UIElement
+    attr_accessor :table
+    attr_accessor :column
+    attr_accessor :element_locator
+
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      @name            = name
+      @parent          = parent
+      @context         = context
+      @alt_locator     = nil
+      @table           = table
+      @column          = column
+      @element_locator = locator
+      @locator         = "#{@table.get_table_cell_locator('ROW_SPEC', @column)}/#{@element_locator}"
+    end
+
+    def set_column(column)
+      @column  = column
+      @locator = "#{@table.get_table_cell_locator('ROW_SPEC', @column)}/#{@element_locator}"
+    end
+
+    def exists?(row)
+      obj, = find_cell_element(row)
+      obj != nil
+    end
+
+    def click(row)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, @type, row)
+      obj.click
+    end
+
+    def get_native_attribute(row, attrib)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, @type, row)
+      obj.get_native_attribute(attrib)
+    end
+
+    def get_value(row, visible = true)
+      obj, = find_cell_element(row, visible)
+      cell_object_not_found_exception(obj, @type, row)
+      case obj.tag_name.downcase
+      when 'input', 'select', 'textarea'
+        obj.value
+      else
+        obj.text
+      end
+    end
+
+    alias get_caption get_value
+
+    def find_cell_element(row, visible = true)
+      set_alt_locator("#{@locator.gsub('ROW_SPEC', row.to_s)}")
+      find_element(visible)
+    end
+
+    def cell_object_not_found_exception(obj, obj_type, row)
+      object_not_found_exception(obj, "Row #{row}/Col #{@column} #{obj_type}")
+    end
+  end
+end

data/lib/testcentricity_web/elements/cell_image.rb

@@ -0,0 +1,8 @@
+module TestCentricity
+  class CellImage < CellElement
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type = :cell_image
+    end
+  end
+end

data/lib/testcentricity_web/elements/cell_radio.rb

@@ -0,0 +1,31 @@
+module TestCentricity
+  class CellRadio < CellElement
+    attr_accessor :proxy
+
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type  = :cell_radio
+      @proxy = proxy
+    end
+
+    def selected?(row)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell Radio', row)
+      obj.checked?
+    end
+
+    def set_selected_state(row, state)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell Radio', row)
+      obj.set(state)
+    end
+
+    def select(row)
+      set_selected_state(row, true)
+    end
+
+    def unselect(row)
+      set_selected_state(row, false)
+    end
+  end
+end

data/lib/testcentricity_web/elements/checkbox.rb

@@ -0,0 +1,99 @@
+module TestCentricity
+  class CheckBox < UIElement
+    attr_accessor :proxy
+
+    def initialize(name, parent, locator, context, proxy = nil)
+      @name        = name
+      @parent      = parent
+      @locator     = locator
+      @context     = context
+      @alt_locator = nil
+      @proxy       = proxy
+      @type        = :checkbox
+    end
+
+    # Does checkbox object exists?
+    #
+    # @return [Boolean]
+    # @example
+    #   remember_me_checkbox.exists?
+    #
+    def exists?
+      obj, = find_object(:all)
+      obj != nil
+    end
+
+    # Is checkbox checked?
+    #
+    # @return [Boolean]
+    # @example
+    #   remember_me_checkbox.checked?
+    #
+    def checked?
+      obj, = find_element(:all)
+      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(:all)
+      object_not_found_exception(obj, 'Checkbox')
+      invalid_object_type_exception(obj, 'checkbox')
+      if @proxy.nil?
+        if obj.native.attribute('ot') == 'JCheckBox'
+          expected = state.to_bool
+          obj.click unless expected == obj.checked?
+        else
+          obj.set(state)
+        end
+      else
+        @proxy.click unless state == obj.checked?
+      end
+    end
+
+    # Set the check state of a checkbox object.
+    #
+    # @example
+    #   remember_me_checkbox.check
+    #
+    def check
+      set_checkbox_state(true)
+    end
+
+    # Uncheck a checkbox object.
+    #
+    # @example
+    #   remember_me_checkbox.uncheck
+    #
+    def uncheck
+      set_checkbox_state(false)
+    end
+
+    def verify_check_state(state, enqueue = false)
+      actual = checked?
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(state, actual, "Expected checkbox #{object_ref_message}") :
+          assert_equal(state, actual, "Expected checkbox #{object_ref_message} 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 "UI #{object_ref_message} 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/file_field.rb

@@ -0,0 +1,45 @@
+module TestCentricity
+  class FileField < UIElement
+    def initialize(name, parent, locator, context)
+      super
+      @type = :filefield
+    end
+
+    def file_attach(file_path)
+      Capybara.ignore_hidden_elements = false
+      page.attach_file(@locator, file_path)
+      Capybara.ignore_hidden_elements = true
+    end
+
+    def file_upload(file_path)
+      obj, = find_element(false)
+      obj.send_keys(file_path)
+    end
+
+    def drop_files(files)
+      js_script = 'fileList = Array();'
+      files.count.times do |i|
+        # generate a fake input selector
+        page.execute_script("if ($('#seleniumUpload#{i}').length == 0) { seleniumUpload#{i} = window.$('<input/>').attr({id: 'seleniumUpload#{i}', type:'file'}).appendTo('body'); }")
+        # attach file to the fake input selector through Capybara
+        attach_file("seleniumUpload#{i}", files[i])
+        # create the fake js event
+        js_script = "#{js_script} fileList.push(seleniumUpload#{i}.get(0).files[0]);"
+      end
+      # trigger the fake drop event
+      page.execute_script("#{js_script} e = $.Event('drop'); e.originalEvent = {dataTransfer : { files : fileList } }; $('#{@locator}').trigger(e);")
+    end
+
+    def ng_drop_file(file_path)
+      # generate a fake input selector
+      page.execute_script("fakeFileInput = window.$('<input/>').attr({ id: 'fileFileInput', type: 'file' }).appendTo('body');")
+      # attach file to the fake input selector through Capybara
+      page.attach_file('fakeFileInput', file_path)
+      # create the fake js event
+      js_script = "var scope = angular.element('#{@locator}').scope();"
+      js_script = "#{js_script} scope.files = [fakeFileInput.get(0).files[0]];"
+      # trigger the fake drop event
+      page.execute_script(js_script)
+    end
+  end
+end

data/lib/testcentricity_web/elements/image.rb

@@ -0,0 +1,34 @@
+module TestCentricity
+  class Image < UIElement
+    def initialize(name, parent, locator, context)
+      super
+      @type = :image
+    end
+
+    # Is image loaded?
+    #
+    # @return [Boolean]
+    # @example
+    #   company_logo_image.is_loaded??
+    #
+    def is_loaded?
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.native.attribute('complete')
+    end
+
+    # Wait until the image is fully loaded, or until the specified wait time has expired.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   company_logo_image.wait_until_loaded(5)
+    #
+    def wait_until_loaded(seconds = nil)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { is_loaded? }
+    rescue
+      raise "Image #{object_ref_message} failed to load within #{timeout} seconds" unless is_loaded?
+    end
+  end
+end

data/lib/testcentricity_web/elements/label.rb

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