testcentricity_mobile 4.0.0

data/lib/testcentricity_mobile/app_elements/checkbox.rb

@@ -0,0 +1,56 @@
+module TestCentricity
+  module AppElements
+    class AppCheckBox < AppUIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type  = :checkbox
+      end
+
+      # Is checkbox checked?
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.checked?
+      #
+      def checked?
+        obj = element
+        object_not_found_exception(obj)
+        obj.selected?
+      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
+
+      # 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 = element
+        object_not_found_exception(obj)
+        if state
+          obj.click unless obj.selected?
+        else
+          obj.click if obj.selected?
+        end
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/app_elements/image.rb

@@ -0,0 +1,10 @@
+module TestCentricity
+  module AppElements
+    class AppImage < AppUIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :image
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/app_elements/label.rb

@@ -0,0 +1,10 @@
+module TestCentricity
+  module AppElements
+    class AppLabel < AppUIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :label
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/app_elements/list.rb

@@ -0,0 +1,175 @@
+module TestCentricity
+  module AppElements
+    class AppList < AppUIElement
+      attr_accessor :list_item
+      attr_accessor :scrolling
+      attr_accessor :item_objects
+
+      def initialize(name, parent, locator, context)
+        super
+        @type = :list
+        @list_item = nil
+        @scrolling = :vertical
+        @item_objects = nil
+      end
+
+      def define_list_elements(element_spec)
+        element_spec.each do |element, value|
+          case element
+          when :list_item
+            @list_item = value
+          when :scrolling
+            @scrolling = value
+          else
+            raise "#{element} is not a recognized list element"
+          end
+        end
+      end
+
+      def scroll_mode
+        obj = element
+        object_not_found_exception(obj)
+        @scrolling
+      end
+
+      def item_refs
+        obj = element
+        object_not_found_exception(obj)
+        @item_objects
+      end
+
+      # Return the number of items in a list object.
+      #
+      # @return [Integer]
+      # @example
+      #   num_nav_items = nav_list.get_item_count
+      #
+      def get_item_count
+        obj = element
+        object_not_found_exception(obj)
+        if Environ.is_ios? && obj.attribute(:type) == 'XCUIElementTypePickerWheel'
+          raise 'This method is not supported for XCUIElementTypePickerWheel controls'
+        end
+        list_loc = get_list_item_locator
+        items = obj.find_elements(list_loc.keys[0], list_loc.values[0])
+        if items.size > 0 && Environ.is_android?
+          start_count = items.count
+          direction = @scrolling == :horizontal ? :right : :down
+          scroll_count = 0
+          loop do
+            save_count = items.count
+            swipe_gesture(direction)
+            scroll_count += 1
+            obj.find_elements(list_loc.keys[0], list_loc.values[0]).each do |item|
+              items.push(item) unless items.include?(item)
+            end
+            break if items.count == save_count
+          end
+          direction = @scrolling == :horizontal ? :left : :up
+          scroll_count.times do
+            swipe_gesture(direction)
+          end
+        end
+        @item_objects = items if Environ.is_android? && start_count < items.count
+        items.count
+      end
+
+      # Return array of strings of all items in a list object.
+      #
+      # @return [Array]
+      # @example
+      #   nav_items = nav_list.get_options
+      #
+      def get_list_items
+        list_items = []
+        obj = element
+        object_not_found_exception(obj)
+        if Environ.is_ios? && obj.attribute(:type) == 'XCUIElementTypePickerWheel'
+          raise 'This method is not supported for XCUIElementTypePickerWheel controls'
+        end
+        list_loc = get_list_item_locator
+        items = obj.find_elements(list_loc.keys[0], list_loc.values[0])
+        items.each do |item|
+          list_items.push(item.text)
+        end
+        list_items
+      end
+
+      # Select the specified item in a list object. Accepts a String or Integer.
+      #
+      # @param item [String, Integer] text or index of item to select
+      #
+      # @example
+      #   province_list.choose_item(2)
+      #   province_list.choose_item('Manitoba')
+      #
+      def choose_item(item)
+        obj = element
+        object_not_found_exception(obj)
+        if Environ.is_ios? && obj.attribute(:type) == 'XCUIElementTypePickerWheel'
+          obj.send_keys(item)
+        else
+          list_loc = get_list_item_locator
+          items = obj.find_elements(list_loc.keys[0], list_loc.values[0])
+          if item.is_a?(Integer)
+            items[item - 1].click
+          else
+            items.each do |list_item|
+              if list_item.text == item
+                list_item.click
+                break
+              end
+            end
+          end
+        end
+      end
+
+      # Wait until the list's item_count equals the specified value, or until the specified wait time has expired. If the
+      # wait time is nil, then the wait time will be Environ.default_max_wait_time.
+      #
+      # @param value [Integer or Hash] value expected or comparison hash
+      # @param seconds [Integer or Float] wait time in seconds
+      # @example
+      #   search_results_list.wait_until_item_count_is(10, 15)
+      #     or
+      #   search_results_list.wait_until_item_count_is({ :greater_than_or_equal => 1 }, 5)
+      #
+      def wait_until_item_count_is(value, seconds = nil)
+        timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+        wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+        wait.until { compare(value, get_item_count) }
+      rescue
+        raise "Value of List #{object_ref_message} failed to equal '#{value}' after #{timeout} seconds" unless get_item_count == value
+      end
+
+      # Wait until the list's item_count changes, or until the specified wait time has expired. If the wait time is nil,
+      # then the wait time will be Environ.default_max_wait_time.
+      #
+      # @param seconds [Integer or Float] wait time in seconds
+      # @example
+      #   search_results_list.wait_until_item_count_changes(10)
+      #
+      def wait_until_item_count_changes(seconds = nil)
+        value = get_item_count
+        timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+        wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+        wait.until { get_item_count != value }
+      rescue
+        raise "Value of List #{object_ref_message} failed to change from '#{value}' after #{timeout} seconds" if get_item_count == value
+      end
+
+      private
+
+      def get_list_item_locator
+        if @list_item.nil?
+          if Environ.device_os == :ios
+            define_list_elements({ :list_item => { class: 'XCUIElementTypeCell' } } )
+          else
+            define_list_elements({ :list_item => { class: 'android.widget.FrameLayout' } } )
+          end
+        end
+        @list_item
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/app_elements/switch.rb

@@ -0,0 +1,66 @@
+module TestCentricity
+  module AppElements
+    class AppSwitch < AppUIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :switch
+      end
+
+      # Is switch in ON state?
+      #
+      # @return [Boolean]
+      # @example
+      #   use_face_id_switch.on?
+      #
+      def on?
+        obj = element
+        object_not_found_exception(obj)
+
+        if Environ.is_ios?
+          state =  obj.attribute(:value)
+          state.to_bool
+        else
+          state = obj.attribute(:checked)
+          state.boolean? ? state : state == 'true'
+        end
+      end
+
+      alias checked? on?
+      alias selected? on?
+
+      # Set the state of a switch object to ON.
+      #
+      # @example
+      #   use_face_id_switch.on
+      #
+      def on
+        obj = element
+        object_not_found_exception(obj)
+        obj.click unless on?
+      end
+
+      # Set the state of a switch object to OFF.
+      #
+      # @example
+      #   use_face_id_switch.off
+      #
+      def off
+        obj = element
+        object_not_found_exception(obj)
+        obj.click if on?
+      end
+
+      # Set the ON/OFF state of a switch object.
+      #
+      # @param state [Boolean] true = on / false = off
+      # @example
+      #   use_face_id_switch.set_switch_state(true)
+      #
+      def set_switch_state(state)
+        obj = element
+        object_not_found_exception(obj)
+        state ? on : off
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/app_elements/textfield.rb

@@ -0,0 +1,51 @@
+module TestCentricity
+  module AppElements
+    class AppTextField < AppUIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :textfield
+      end
+
+      # Is text field set to read-only?
+      #
+      # @return [Boolean]
+      # @example
+      #   comments_field.read_only?
+      #
+      def read_only?
+        obj = element
+        object_not_found_exception(obj)
+        !!obj.attribute('readonly')
+      end
+
+      # Return maxlength character count of a text field.
+      #
+      # @return [Integer]
+      # @example
+      #   max_num_chars = comments_field.get_max_length
+      #
+      def get_max_length
+        obj = element
+        object_not_found_exception(obj)
+        max_length = obj.attribute('maxlength')
+        max_length.to_i unless max_length.blank?
+      end
+
+      # Return placeholder text of a text field.
+      #
+      # @return [String]
+      # @example
+      #   placeholder_message = username_field.get_placeholder
+      #
+      def get_placeholder
+        obj = element
+        object_not_found_exception(obj)
+        if AppiumConnect.is_webview?
+          obj.attribute('placeholder')
+        else
+          obj.text
+        end
+      end
+    end
+  end
+end

data/lib/testcentricity_mobile/appium_server.rb

@@ -0,0 +1,71 @@
+require 'childprocess'
+
+#
+# This class is designed to start and stop the Appium Server process.  In order to use it you must have Appium
+# and node installed on your computer.  You can pass parameters to Appium at startup via the constructor.
+#
+module TestCentricity
+  class AppiumServer
+    attr_accessor :process
+
+    def initialize(params = {})
+      @params = params
+    end
+
+    #
+    # Start the Appium Server
+    #
+    def start
+      # terminate any currently running Appium Server
+      if running?
+        system('killall -9 node')
+        puts 'Terminating existing Appium Server'
+        sleep(5)
+        puts 'Appium Server is being restarted'
+      else
+        puts 'Appium Server is starting'
+      end
+      # start new Appium Server
+      @process = ChildProcess.build(*parameters)
+      process.start
+      # wait until confirmation that Appium Server is running
+      wait = Selenium::WebDriver::Wait.new(timeout: 30)
+      wait.until { running? }
+      puts "Appium Server is running - PID = #{process.pid}"
+    end
+
+    #
+    # Check to see if Appium Server is running
+    #
+    def running?
+      response = false
+      begin
+        response = Net::HTTP.get_response(URI('http://0.0.0.0:4723/wd/hub/sessions'))
+      rescue
+      end
+      response && response.code_type == Net::HTTPOK
+    end
+
+    #
+    # Stop the Appium Server
+    #
+    def stop
+      process.stop
+      puts 'Appium Server has been terminated'
+    end
+
+    private
+
+    # :nocov:
+    def parameters
+      cmd = ['appium']
+      @params.each do |key, value|
+        cmd << '--' + key.to_s
+        cmd << value.to_s if not value.nil? and value.size > 0
+      end
+      cmd
+    end
+    # :nocov:
+  end
+end
+

data/lib/testcentricity_mobile/data_objects/data_objects_helper.rb

@@ -0,0 +1,100 @@
+require 'yaml'
+require 'json'
+require 'virtus'
+require 'time'
+require 'chronic'
+require 'faker'
+
+
+module TestCentricity
+
+  PRIMARY_DATA_PATH ||= 'config/test_data/'
+  PRIMARY_DATA_FILE ||= "#{PRIMARY_DATA_PATH}data."
+  YML_PRIMARY_DATA_FILE  ||= "#{PRIMARY_DATA_FILE}yml"
+  JSON_PRIMARY_DATA_FILE ||= "#{PRIMARY_DATA_FILE}json"
+
+
+  class DataObject
+    attr_accessor :current
+    attr_accessor :context
+    attr_accessor :hash_table
+
+    def initialize(data)
+      @hash_table = data
+    end
+
+    def self.current
+      @current
+    end
+
+    def self.current=(current)
+      @current = current
+    end
+  end
+
+
+  class DataPresenter
+    include Virtus.model
+
+    attr_accessor :current
+    attr_accessor :context
+
+    def initialize(data)
+      self.attributes = data unless data.nil?
+    end
+
+    def self.current
+      @current
+    end
+
+    def self.current=(current)
+      @current = current
+    end
+  end
+
+
+# :nocov:
+  class DataSource
+    attr_accessor :file_path
+    attr_accessor :node
+
+    def read_yaml_node_data(file_name, node_name)
+      @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
+      @node = node_name
+      data = YAML.load_file(@file_path)
+      data[node_name]
+    end
+
+    def read_json_node_data(file_name, node_name)
+      @file_path = "#{PRIMARY_DATA_PATH}#{file_name}"
+      @node = node_name
+      raw_data = File.read(@file_path)
+      data = JSON.parse(raw_data)
+      data[node_name]
+    end
+
+    private
+
+    def self.calculate_dynamic_value(value)
+      test_value = value.split('!', 2)
+      parameter = test_value[1].split('.', 2)
+      case parameter[0]
+      when 'Date'
+        result = eval("Chronic.parse('#{parameter[1]}')")
+      when 'FormattedDate', 'FormatDate'
+        date_time_params = parameter[1].split(' format! ', 2)
+        date_time = eval("Chronic.parse('#{date_time_params[0].strip}')")
+        result = date_time.to_s.format_date_time("#{date_time_params[1].strip}")
+      else
+        result = if Faker.constants.include?(parameter[0].to_sym)
+                   eval("Faker::#{parameter[0]}.#{parameter[1]}")
+                 else
+                   eval(test_value[1])
+                 end
+      end
+      result.to_s
+    end
+  end
+# :nocov:
+end
+