testa_appium_driver 0.1.18 → 0.1.20

data/lib/testa_appium_driver/android/locator.rb

@@ -1,142 +0,0 @@
-require_relative 'locator/attributes'
-
-module TestaAppiumDriver
-  #noinspection RubyTooManyInstanceVariablesInspection
-  class Locator
-    attr_accessor :closing_parenthesis
-    include ClassSelectors
-    include Attributes
-
-    def init(params, selectors, single)
-      @closing_parenthesis = 0
-
-
-      @ui_selector = hash_to_uiautomator(selectors, single)
-
-      if is_scrollable_selector?(selectors, single)
-        if selectors[:class] == "android.widget.HorizontalScrollView"
-          @scroll_orientation = :horizontal
-        else
-          @scroll_orientation = :vertical
-        end
-
-        if !params[:top].nil? || !params[:bottom].nil? || !params[:right].nil? || !params[:left].nil?
-          @scroll_deadzone = {}
-          @scroll_deadzone[:top] = params[:top].to_f unless params[:top].nil?
-          @scroll_deadzone[:bottom] = params[:bottom].to_f unless params[:bottom].nil?
-          @scroll_deadzone[:right] = params[:right].to_f unless params[:right].nil?
-          @scroll_deadzone[:left] = params[:left].to_f unless params[:left].nil?
-        end
-
-        params[:scrollable_locator] = self.dup
-      end
-
-      @scrollable_locator = params[:scrollable_locator] if params[:scrollable_locator]
-    end
-
-
-    # resolve selector which will be used for finding element
-    def strategies_and_selectors
-      ss = []
-      if @can_use_id_strategy
-        ss.push({"#{FIND_STRATEGY_ID}": @can_use_id_strategy})
-      end
-      if @strategy.nil? || @strategy == FIND_STRATEGY_UIAUTOMATOR
-        ss.push({"#{FIND_STRATEGY_UIAUTOMATOR}": ui_selector})
-      end
-
-      if @strategy.nil? || @strategy == FIND_STRATEGY_XPATH
-        ss.push({"#{FIND_STRATEGY_XPATH}": @xpath_selector})
-      end
-
-      if @strategy == FIND_STRATEGY_IMAGE
-        ss.push({"#{FIND_STRATEGY_IMAGE}": @image_selector})
-      end
-      ss
-    end
-
-
-    # @param [Boolean] include_semicolon should the semicolon be included at the end
-    # @return ui_selector for uiautomator find strategy
-    def ui_selector(include_semicolon = true)
-      @ui_selector + ")" * @closing_parenthesis + (include_semicolon ? ";" : "");
-    end
-
-    def ui_selector=(value)
-      @ui_selector = value
-    end
-
-
-
-
-    # @return [TestaAppiumDriver::Locator]
-    def from_parent(selectors = {})
-      raise "Cannot add from_parent selector to array" unless @single
-      raise StrategyMixException.new(@strategy, @strategy_reason, FIND_STRATEGY_UIAUTOMATOR, "from_parent") if @strategy != FIND_STRATEGY_UIAUTOMATOR
-
-      locator = self.dup
-      locator.strategy = FIND_STRATEGY_UIAUTOMATOR
-      locator.strategy_reason = "from_parent"
-      locator.closing_parenthesis += 1
-      locator.ui_selector = "#{locator.ui_selector}.fromParent(#{hash_to_uiautomator(selectors)}"
-      locator
-    end
-
-
-    # @return [Locator] new child locator element
-    def add_child_selector(params)
-      params, selectors = extract_selectors_from_params(params)
-      single = params[:single]
-      raise "Cannot add child selector to Array" if single && !@single
-
-      locator = self.dup
-      locator.can_use_id_strategy = false
-      if (@strategy.nil? && !single) || @strategy == FIND_STRATEGY_XPATH
-        locator.strategy = FIND_STRATEGY_XPATH
-        locator.strategy_reason = "multiple child selector"
-        add_xpath_child_selectors(locator, selectors, single)
-      elsif @strategy == FIND_STRATEGY_UIAUTOMATOR
-        locator = add_uiautomator_child_selector(locator, selectors, single)
-      elsif @strategy == FIND_STRATEGY_IMAGE
-        locator = add_image_child_selector(locator, selectors, single)
-      else
-        # both paths are valid
-        add_xpath_child_selectors(locator, selectors, single)
-        locator = add_uiautomator_child_selector(locator, selectors, single)
-      end
-
-      if is_scrollable_selector?(selectors, single)
-        locator.scrollable_locator = locator
-        if selectors[:class] == "android.widget.HorizontalScrollView"
-          locator.scrollable_locator.scroll_orientation = :horizontal
-        else
-          locator.scrollable_locator.scroll_orientation = :vertical
-        end
-      end
-
-      locator.last_selector_adjacent = false
-      locator
-    end
-
-
-    private
-    def add_uiautomator_child_selector(locator, selectors, single)
-      if locator.single && !single
-        # current locator stays single, the child locator looks for multiple
-        params = selectors.merge({single: single, scrollable_locator: locator.scrollable_locator})
-        params[:default_find_strategy] = locator.default_find_strategy
-        params[:default_scroll_strategy] = locator.default_scroll_strategy
-        Locator.new(@driver, self, params)
-      else
-        locator.single = true
-        locator.ui_selector = "#{locator.ui_selector(false)}.childSelector(#{hash_to_uiautomator(selectors, single)})"
-        locator
-      end
-    end
-
-    def add_image_child_selector(locator, selectors, single)
-      params = selectors.merge({single: single, scrollable_locator: locator.scrollable_locator})
-      Locator.new(@driver, self, params)
-    end
-  end
-end

data/lib/testa_appium_driver/android/scroll_actions/uiautomator_scroll_actions.rb

@@ -1,62 +0,0 @@
-module TestaAppiumDriver
-  #noinspection RubyInstanceMethodNamingConvention
-  class ScrollActions
-    private
-
-    def uiautomator_scroll_to_start_or_end(type)
-
-      scrollable_selector = @scrollable.ui_selector(false)
-      orientation = @scrollable.scroll_orientation == :vertical ? ".setAsVerticalList()" : ".setAsHorizontalList()"
-      scroll_command = type == :start ? ".scrollToBeginning(#{DEFAULT_UIAUTOMATOR_MAX_SWIPES})" : ".scrollToEnd(#{DEFAULT_UIAUTOMATOR_MAX_SWIPES})"
-      cmd = "new UiScrollable(#{scrollable_selector})#{orientation}#{scroll_command};"
-      begin
-        puts "Scroll execute[uiautomator_#{type}]: #{cmd}"
-        @driver.find_element(uiautomator: cmd)
-      rescue
-        # Ignored
-      end
-
-
-    end
-
-
-    def uiautomator_scroll_to
-      raise "UiAutomator scroll cannot work with specified direction" unless @direction.nil?
-
-      scrollable_selector = @scrollable.ui_selector(false)
-      element_selector = @locator.ui_selector(false)
-      orientation_command = @scrollable.scroll_orientation == :vertical ? ".setAsVerticalList()" : ".setAsHorizontalList()"
-      cmd = "new UiScrollable(#{scrollable_selector})#{orientation_command}.scrollIntoView(#{element_selector});"
-      begin
-        puts "Scroll execute[uiautomator_scroll_to]: #{cmd}"
-        @driver.find_element(uiautomator: cmd)
-      rescue
-        # Ignored
-      ensure
-      end
-    end
-
-
-    def uiautomator_page_or_fling(type, direction)
-      scrollable_selector = @scrollable.ui_selector(false)
-      orientation = direction == :up || direction == :down ? ".setAsVerticalList()" : ".setAsHorizontalList()"
-      if type == SCROLL_ACTION_TYPE_SCROLL
-        direction_command = direction == :down || direction == :right ? ".scrollForward()" : ".scrollBackward()"
-      elsif type == SCROLL_ACTION_TYPE_FLING
-        direction_command = direction == :down || direction == :right ? ".flingForward()" : ".flingBackward()"
-      else
-        raise "Unknown scroll action type #{type}"
-      end
-      cmd = "new UiScrollable(#{scrollable_selector})#{orientation}#{direction_command};"
-      begin
-        puts "Scroll execute[uiautomator_#{type}]: #{cmd}"
-        @driver.find_element(uiautomator: cmd)
-      rescue
-        # Ignored
-      end
-    end
-
-
-  end
-
-end

data/lib/testa_appium_driver/android/selenium_element.rb

@@ -1,12 +0,0 @@
-module ::Appium
-  module Core
-    class Element
-      include TestaAppiumDriver::ClassSelectors
-      include TestaAppiumDriver::Attributes
-
-      def parent
-        self.find_element(xpath: "./..")
-      end
-    end
-  end
-end

data/lib/testa_appium_driver/common/bounds.rb

@@ -1,150 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-module TestaAppiumDriver
-  class Bounds
-
-    attr_reader :width
-    attr_reader :height
-    attr_reader :offset
-
-
-    # @param top_left [Coordinates]
-    # @param bottom_right [Coordinates]
-    # @param window_width [Integer]
-    # @param window_height [Integer]
-    def initialize(top_left, bottom_right, window_width, window_height)
-      @top_left = top_left
-      @bottom_right = bottom_right
-      @width = bottom_right.x - top_left.x
-      @height = bottom_right.y - top_left.y
-      @offset = Offset.new(self, window_width, window_height)
-      @center = TestaAppiumDriver::Coordinates.new(@top_left.x + @width/2, @top_left.y + @height / 2)
-    end
-
-    def as_json
-      {
-        width: @width,
-        height: @height,
-        top_left: @top_left.as_json,
-        bottom_right: @bottom_right.as_json,
-        offset: @offset.as_json
-      }
-    end
-
-    # @return [TestaAppiumDriver::Offset]
-    def offset
-      @offset
-    end
-
-    # @return [TestaAppiumDriver::Coordinates]
-    def top_left
-      @top_left
-    end
-    # @return [TestaAppiumDriver::Coordinates]
-    def bottom_right
-      @bottom_right
-    end
-
-    # @return [TestaAppiumDriver::Coordinates]
-    def center
-      @center
-    end
-
-    def to_s
-      JSON.dump(as_json)
-    end
-
-    # @param bounds [String] bounds that driver.attribute("bounds") return
-    # @param driver [TestaAppiumDriver::Driver]
-    def self.from_android(bounds, driver)
-      matches = bounds.match(/\[(\d+),(\d+)\]\[(\d+),(\d+)\]/)
-      raise "Unexpected bounds: #{bounds}" unless matches
-
-      captures = matches.captures
-      top_left = Coordinates.new(captures[0], captures[1])
-      bottom_right = Coordinates.new(captures[2], captures[3])
-      ws = driver.window_size
-      window_width = ws.width.to_i
-      window_height = ws.height.to_i
-      Bounds.new(top_left, bottom_right, window_width, window_height)
-    end
-
-    def self.from_ios(rect, driver)
-      rect = JSON.parse(rect)
-      top_left = Coordinates.new(rect["x"], rect["y"])
-      bottom_right = Coordinates.new(top_left.x + rect["width"].to_i, top_left.y + rect["height"].to_i)
-      ws = driver.window_size
-      window_width = ws.width.to_i
-      window_height = ws.height.to_i
-      Bounds.new(top_left, bottom_right, window_width, window_height)
-    end
-  end
-
-  #noinspection ALL
-  class Coordinates
-    def initialize(x, y)
-      @x = x.to_i
-      @y = y.to_i
-    end
-
-    def as_json
-      {
-        x: @x,
-        y: @y
-      }
-    end
-
-
-    # @return [Integer]
-    def x
-      @x
-    end
-
-    # @return [Integer]
-    def y
-      @y
-    end
-  end
-
-
-  class Offset
-    def initialize(bounds, window_width, window_height)
-      @top = bounds.top_left.y
-      @right = window_width - bounds.bottom_right.x
-      @bottom = window_height - bounds.bottom_right.y
-      @left = bounds.top_left.x
-    end
-
-    def as_json
-      {
-        top: @top,
-        right: @right,
-        bottom: @bottom,
-        left: @left
-      }
-    end
-
-
-    # @return [Integer]
-    def top
-      @top
-    end
-
-    # @return [Integer]
-    def right
-      @right
-    end
-
-    # @return [Integer]
-    def bottom
-      @bottom
-    end
-
-    # @return [Integer]
-    def left
-      @left
-    end
-
-  end
-end

data/lib/testa_appium_driver/common/constants.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-#noinspection ALL
-module TestaAppiumDriver
-  FIND_STRATEGY_UIAUTOMATOR = :uiautomator
-  FIND_STRATEGY_XPATH = :xpath
-  FIND_STRATEGY_ID = :id
-  FIND_STRATEGY_NAME = :name
-  FIND_STRATEGY_IMAGE = :image
-  FIND_STRATEGY_CLASS_CHAIN = :class_chain
-
-  SCROLL_STRATEGY_UIAUTOMATOR = :uiautomator
-  SCROLL_STRATEGY_W3C = :w3c
-
-
-  SCROLL_CORRECTION_W3C = 30
-  SCROLL_ALIGNMENT_THRESHOLD = 25
-
-  SCROLL_ACTION_TYPE_SCROLL = :scroll
-  SCROLL_ACTION_TYPE_FLING = :fling
-  SCROLL_ACTION_TYPE_DRAG = :drag
-
-
-  DEFAULT_UIAUTOMATOR_MAX_SWIPES = 20
-
-  DEFAULT_ANDROID_FIND_STRATEGY = FIND_STRATEGY_UIAUTOMATOR
-  #DEFAULT_ANDROID_SCROLL_STRATEGY = SCROLL_STRATEGY_UIAUTOMATOR
-  DEFAULT_ANDROID_SCROLL_STRATEGY = SCROLL_STRATEGY_W3C
-
-
-  DEFAULT_IOS_FIND_STRATEGY = FIND_STRATEGY_XPATH
-  DEFAULT_IOS_SCROLL_STRATEGY = SCROLL_STRATEGY_W3C
-
-  DEFAULT_W3C_MAX_SCROLLS = 7
-
-  EXISTS_WAIT = 0.5
-  LONG_TAP_DURATION = 1.5
-end

data/lib/testa_appium_driver/common/exceptions/strategy_mix_exception.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module TestaAppiumDriver
-  class StrategyMixException < Exception
-    def initialize(strategy, strategy_reason, mixed_strategy, mixed_reason)
-
-      # example: parent is only available in xpath strategy and cannot be used with from_element which is only available in uiautomator strategy
-      msg = "strategy mix exception: '#{strategy_reason}' is only available in #{strategy} strategy and cannot be used with '#{mixed_reason}' which is only available in #{mixed_strategy} strategy"
-      super(msg)
-    end
-  end
-end

data/lib/testa_appium_driver/common/helpers.rb

@@ -1,271 +0,0 @@
-module TestaAppiumDriver
-  module Helpers
-
-    # supported selectors
-    # id: "com.my.package:id/myId"
-    # id: "myId" => will be converted to "com.my.package:id/myId"
-    # id: /my/ will find all elements with ids that contain my
-    # desc: "element description"
-    # desc: /ription/ will find all elements that contains ription
-    # class: "android.widget.Button"
-    # class: /Button/ will find all elements with classes that contain Button
-    # text: "Hello world"
-    # text: /ello/ will find all elements with text that contain ello
-    # package: "com.my.package"
-    # package: /my/ will find all elements with package that contains my
-    # long_clickable: true or false
-    # checkable: true or false
-    # checked: true or false
-    # clickable: true or false
-    # enabled: true or false
-    # focusable: true or false
-    # focused: true or false
-    # index: child index inside of a parent element, index starts from 0
-    # selected: true or false
-    # scrollable: true or false
-    # @param [Hash] hash selectors for finding elements
-    # @param [Boolean] single should the command return first instance or all of matched elements
-    # @return [String] hash selectors converted to uiautomator command
-    def hash_to_uiautomator(hash, single = true)
-      command = "new UiSelector()"
-
-      id = resolve_id(hash[:id])
-      command = "#{ command }.resourceId(\"#{ %(#{ id }) }\")" if id && id.kind_of?(String)
-      command = "#{ command }.resourceIdMatches(\".*#{ %(#{ id.source }) }.*\")" if id && id.kind_of?(Regexp)
-      command = "#{ command }.description(\"#{ %(#{ hash[:desc] }) }\")" if hash[:desc] && hash[:desc].kind_of?(String)
-      command = "#{ command }.descriptionMatches(\".*#{ %(#{ hash[:desc].source }) }.*\")" if hash[:desc] && hash[:desc].kind_of?(Regexp)
-      command = "#{ command }.className(\"#{ %(#{ hash[:class] }) }\")" if hash[:class] && hash[:class].kind_of?(String)
-      command = "#{ command }.classNameMatches(\".*#{ %(#{ hash[:class].source }) }.*\")" if hash[:class] && hash[:class].kind_of?(Regexp)
-      command = "#{ command }.text(\"#{ %(#{ hash[:text] }) }\")" if hash[:text] && hash[:text].kind_of?(String)
-      command = "#{ command }.textMatches(\".*#{ %(#{ hash[:text].source }) }.*\")" if hash[:text] && hash[:text].kind_of?(Regexp)
-      command = "#{ command }.packageName(\"#{ %(#{ hash[:package] }) }\")" if hash[:package] && hash[:package].kind_of?(String)
-      command = "#{ command }.packageNameMatches(\".*#{ %(#{ hash[:package].source }) }.*\")" if hash[:package] && hash[:package].kind_of?(Regexp)
-
-      command = "#{ command }.longClickable(#{ hash[:long_clickable] })" if hash[:long_clickable]
-      command = "#{ command }.checkable(#{ hash[:checkable] })" unless hash[:checkable].nil?
-      command = "#{ command }.checked(#{ hash[:checked] })" unless hash[:checked].nil?
-      command = "#{ command }.clickable(#{ hash[:clickable] })" unless hash[:clickable].nil?
-      command = "#{ command }.enabled(#{ hash[:enabled] })" unless hash[:enabled].nil?
-      command = "#{ command }.focusable(#{ hash[:focusable] })" unless hash[:focusable].nil?
-      command = "#{ command }.focused(#{ hash[:focused] })" unless hash[:focused].nil?
-      command = "#{ command }.index(#{ hash[:index].to_s })" unless hash[:index].nil?
-      command = "#{ command }.selected(#{ hash[:selected] })" unless hash[:selected].nil?
-      command = "#{ command }.scrollable(#{ hash[:scrollable] })" unless hash[:scrollable].nil?
-
-      command += ".instance(0)" if single
-
-      command
-    end
-
-
-    # supported selectors
-    # id: "com.my.package:id/myId"
-    # id: "myId" => will be converted to "com.my.package:id/myId"
-    # id: /my/ will find all elements with ids that contain my
-    # desc: "element description"
-    # desc: /ription/ will find all elements that contains ription
-    # class: "android.widget.Button"
-    # class: /Button/ will find all elements with classes that contain Button
-    # text: "Hello world"
-    # text: /ello/ will find all elements with text that contain ello
-    # package: "com.my.package"
-    # package: /my/ will find all elements with package that contains my
-    # long_clickable: true or false
-    # checkable: true or false
-    # checked: true or false
-    # clickable: true or false
-    # enabled: true or false
-    # focusable: true or false
-    # focused: true or false
-    # index: child index inside of a parent element, index starts from 0
-    # selected: true or false
-    # scrollable: true or false
-    # @param [Hash] hash selectors for finding elements
-    # @param [Boolean] single should the command return first instance or all of matched elements
-    # @return [String] hash selectors converted to xpath command
-    def hash_to_xpath(device, hash, single = true)
-      for_android = device == :android
-
-
-      command = "//"
-
-
-
-      if for_android
-        id = resolve_id(hash[:id])
-        if hash[:class] && hash[:class].kind_of?(String)
-          command = "#{ command }#{hash[:class] }"
-        elsif hash[:class] && hash[:class].kind_of?(Regexp)
-          command = "#{ command}*[contains(@class, \"#{ %(#{hash[:class].source }) }\")]"
-        else
-          command = "#{command}*"
-        end
-
-        # TODO: with new uiautomator sever you can use matches to look with regex instead of contains
-        command = "#{ command }[@resource-id=\"#{ %(#{ id }) }\"]" if  id &&  id.kind_of?(String)
-        command = "#{ command }[contains(@resource-id, \"#{ %(#{ id.source }) }\")]" if  id &&  id.kind_of?(Regexp)
-        command = "#{ command }[@content-desc=\"#{ %(#{hash[:desc] }) }\"]" if hash[:desc] && hash[:desc].kind_of?(String)
-        command = "#{ command }[contains(@content-desc, \"#{ %(#{hash[:desc].source }) }\")]" if hash[:desc] && hash[:desc].kind_of?(Regexp)
-        command = "#{ command }[contains(@class, \"#{ %(#{hash[:class].source }) }\")]" if hash[:class] && hash[:class].kind_of?(Regexp)
-        command = "#{ command }[@text=\"#{ %(#{hash[:text] }) }\"]" if hash[:text] && hash[:text].kind_of?(String)
-        command = "#{ command }[contains(@text, \"#{ %(#{hash[:text].source }) }\")]" if hash[:text] && hash[:text].kind_of?(Regexp)
-        command = "#{ command }[@package=\"#{ %(#{hash[:package] }) }\"]" if hash[:package] && hash[:package].kind_of?(String)
-        command = "#{ command }[contains=(@package, \"#{ %(#{hash[:package].source }) }\")]" if hash[:package] && hash[:package].kind_of?(Regexp)
-        command = "#{ command }[@long-clickable=\"#{ hash[:long_clickable] }\"]" if hash[:long_clickable]
-        command = "#{ command }[@checkable=\"#{ hash[:checkable] }\"]" unless hash[:checkable].nil?
-        command = "#{ command }[@checked=\"#{ hash[:checked] }\"]" unless hash[:checked].nil?
-        command = "#{ command }[@clickable=\"#{ hash[:clickable] }\"]" unless hash[:clickable].nil?
-        command = "#{ command }[@enabled=\"#{ hash[:enabled] }\"]" unless hash[:enabled].nil?
-        command = "#{ command }[@focusable=\"#{ hash[:focusable] }\"]" unless hash[:focusable].nil?
-        command = "#{ command }[@focused=\"#{ hash[:focused] }\"]" unless hash[:focused].nil?
-        command = "#{ command }[@index=\"#{ hash[:index] }\"]" unless hash[:index].nil?
-        command = "#{ command }[@selected=\"#{ hash[:selected] }\"]" unless hash[:selected].nil?
-
-        # it seems like you cannot query by scrollable
-        # command = "#{ command }[@scrollable=\"#{ hash[:scrollable] }\"]" unless hash[:scrollable].nil?
-      else
-
-        hash[:type] = hash[:class] unless hash[:class].nil?
-        if hash[:type] && hash[:type].kind_of?(String)
-          command = "#{ command }#{hash[:type] }"
-        elsif hash[:type] && hash[:type].kind_of?(Regexp)
-          command = "#{ command}*[contains(@type, \"#{ %(#{hash[:type].source }) }\")]"
-        else
-          command = "#{command}*"
-        end
-
-
-        #  # ios specific
-        hash[:label] = hash[:text] unless hash[:text].nil?
-        hash[:name] = hash[:id] unless hash[:id].nil?
-
-        command = "#{ command }[@enabled=\"#{ hash[:enabled] }\"]" unless hash[:enabled].nil?
-        command = "#{ command }[@label=\"#{ %(#{hash[:label] }) }\"]" if hash[:label] && hash[:label].kind_of?(String)
-        command = "#{ command }[contains(@label, \"#{ %(#{hash[:label].source }) }\")]" if hash[:label] && hash[:label].kind_of?(Regexp)
-        command = "#{ command }[@name=\"#{ %(#{hash[:name] }) }\"]" if hash[:name] && hash[:name].kind_of?(String)
-        command = "#{ command }[contains(@name, \"#{ %(#{hash[:name].source }) }\")]" if hash[:name] && hash[:name].kind_of?(Regexp)
-        command = "#{ command }[@value=\"#{ %(#{hash[:value] }) }\"]" if hash[:value] && hash[:value].kind_of?(String)
-        command = "#{ command }[contains(@value, \"#{ %(#{hash[:value].source }) }\")]" if hash[:value] && hash[:value].kind_of?(Regexp)
-        command = "#{ command }[@width=\"#{ hash[:width] }\"]" unless hash[:width].nil?
-        command = "#{ command }[@height=\"#{ hash[:height] }\"]" unless hash[:height].nil?
-        command = "#{ command }[@visible=\"#{ hash[:visible] }\"]" unless hash[:visible].nil?
-      end
-
-
-      command += "[1]" if single
-
-      command
-    end
-
-
-    def hash_to_class_chain(hash, single = true)
-      command = "**/"
-
-      hash[:type] = hash[:class] unless hash[:class].nil?
-      hash[:label] = hash[:text] unless hash[:text].nil?
-      hash[:name] = hash[:id] unless hash[:id].nil?
-      if hash[:type] && hash[:type].kind_of?(String)
-        command = "#{ command }#{hash[:type] }"
-      else
-        command = "#{command}*"
-      end
-
-      command = "#{ command }[`enabled == #{ hash[:enabled] }`]" unless hash[:enabled].nil?
-      command = "#{ command }[`label == \"#{ %(#{hash[:label] }) }\"`]" if hash[:label] && hash[:label].kind_of?(String)
-      command = "#{ command }[`label CONTAINS \"#{ %(#{hash[:label].source }) }\"`]" if hash[:label] && hash[:label].kind_of?(Regexp)
-      command = "#{ command }[`name == \"#{ %(#{hash[:name] }) }\"`]" if hash[:name] && hash[:name].kind_of?(String)
-      command = "#{ command }[`name CONTAINS \"#{ %(#{hash[:name].source }) }\"`]" if hash[:name] && hash[:name].kind_of?(Regexp)
-      command = "#{ command }[`value == \"#{ %(#{hash[:value] }) }\"`]" if hash[:value] && hash[:value].kind_of?(String)
-      command = "#{ command }[`value CONTAINS \"#{ %(#{hash[:value].source }) }\"`]" if hash[:value] && hash[:value].kind_of?(Regexp)
-      command = "#{ command }[`visible == #{ hash[:visible] }`]" unless hash[:visible].nil?
-
-      command += "[1]" if single
-
-      command
-    end
-
-    # check if selectors are for a scrollable element
-    # @param [Boolean] single should the command return first instance or all of matched elements
-    # @param [Hash] selectors for fetching elements
-    # @return [Boolean] true if element has scrollable attribute true or is class one of (RecyclerView, HorizontalScrollView, ScrollView, ListView)
-    def is_scrollable_selector?(selectors, single)
-      return false unless single
-      return true if selectors[:scrollable]
-      if selectors[:class] == "androidx.recyclerview.widget.RecyclerView" ||
-          selectors[:class] == "android.widget.HorizontalScrollView" ||
-          selectors[:class] == "android.widget.ScrollView" ||
-          selectors[:class] == "android.widget.ListView"
-        return true
-      elsif selectors[:type] == "XCUIElementTypeScrollView"
-        return true
-      end
-      false
-    end
-
-    #noinspection RubyUnnecessaryReturnStatement,RubyUnusedLocalVariable
-    # separate selectors from given hash parameters
-    # @param [Hash] params
-    # @return [Array] first element is params, second are selectors
-    def extract_selectors_from_params(params = {})
-      selectors = params.select { |key, value| [
-          :id,
-          :long_clickable,
-          :desc,
-          :class,
-          :text,
-          :package,
-          :checkable,
-          :checked,
-          :clickable,
-          :enabled,
-          :focusable,
-          :focused,
-          :index,
-          :selected,
-          :scrollable,
-
-          # ios specific
-          :type,
-          :label,
-          :x,
-          :y,
-          :width,
-          :height,
-          :visible,
-          :name,
-          :value,
-
-          :image
-      ].include?(key) }
-      params = Hash[params.to_a - selectors.to_a]
-
-      # default params
-      params[:single] = true if params[:single].nil?
-      params[:scrollable_locator] = nil if params[:scrollable_locator].nil?
-      if params[:default_find_strategy].nil?
-        params[:default_find_strategy] = DEFAULT_ANDROID_FIND_STRATEGY if @driver.device == :android
-        params[:default_find_strategy] = DEFAULT_IOS_FIND_STRATEGY if @driver.device == :ios || @driver.device == :tvos
-      end
-      if params[:default_scroll_strategy].nil?
-        params[:default_scroll_strategy] = DEFAULT_ANDROID_SCROLL_STRATEGY if @driver.device == :android
-        params[:default_scroll_strategy] = DEFAULT_IOS_SCROLL_STRATEGY if @driver.device == :ios || @driver.device == :tvos
-      end
-
-      return params, selectors
-    end
-
-
-    def resolve_id(id)
-      if id && id.kind_of?(String) && !id.match?(/.*:id\//)
-        # shorthand ids like myId make full ids => my.app.package:id/myId
-        if id[0] == "="
-          return id[1..-1]
-        else
-          return "#{@driver.current_package}:id/#{id}"
-        end
-      else
-        id
-      end
-    end
-  end
-end