testa_appium_driver 0.1.21 → 0.1.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35970b2319cff108343afdcca673df9d37364e94749bf3629e6e0955f6d347da
-  data.tar.gz: 71e550aa65923760e70ea56cf741754f29da6cee0f76fe3961a0feb83de8d5ea
+  metadata.gz: 2d4072a112f915874326c2dd4688ecd7680dd419e4d659cc262f4eb2150850e2
+  data.tar.gz: b0a5d24eebc08ed72c2df8959a96163510736d4d4bd0c7eecd9399a218086a29
 SHA512:
-  metadata.gz: 69dbf2de2a6965fc651e7c48ee9be9c6b0df74e917059611b9f041521ae77fc57a4921c7927493e8c21f69a051ceebc9cff3a3d3d1edfcac49253fee955d5ac4
-  data.tar.gz: ce1ca37983d0f72560fbc61f29883aa9e6f58c38625f6f85995684c09d469c1fa99ec70a583d7b71ab02edc9fe48413da4a60ce7a23549e041db4983e6055f46
+  metadata.gz: f3947b6ac11661d053db77491a1619af9f11509f47f9eeb09505d82387772e55183765da00c359f516f0a718d00c0fe70a51f5208a90f8dad281e9f03ac7d6e1
+  data.tar.gz: 5f4960777da0242b0faa11ef8848864e1dfcc08ca08e74efb37f86b3948191ef8e47a0c57e31cfa2464894b62db8613e05b377a7aedb654dbd056a33a82de2be

data/.gitattributes

@@ -0,0 +1,23 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto
+
+# Declare files that will always have LF line endings on checkout.
+*.rb text eol=lf
+*.yml text eol=lf
+*.sh text eol=lf
+*.Dockerfile eol=lf
+*.dockerfile eol=lf
+*.conf eol=lf
+*.ru eol=lf
+*.json eol=lf
+*.js eol=lf
+*.css eol=lf
+*.erb eol=lf
+*.html eol=lf
+*.map eol=lf
+
+# Denote all files that are truly binary and should not be modified.
+*.png binary
+*.jpg binary
+*.bin binary
+*.zip binary

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+/.idea/deployment.xml
+/.idea/workspace.xml
+/.idea/misc.xml
+testa_appium_driver-*.gem
+/appium-driver.iml

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,6 @@
+# we have to have per project rubcop files (IDE limitation),
+# but we want only one config across all projects
+# you can override any global cops here, in this file
+inherit_from:
+  - ../../.rubocop.yml
+  - ../../.rubocop-performance.yml

data/bin/console

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+
+#noinspection RubyResolve
+require "testa_appium_driver"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/testa_appium_driver/android/class_selectors.rb

@@ -0,0 +1,438 @@
+module ::TestaAppiumDriver
+  #noinspection ALL
+  module ClassSelectors
+
+    # @return [TestaAppiumDriver::Locator]
+    def add_selector(*args, &block)
+      # if class selector is executed from driver, create new locator instance
+      if self.kind_of?(TestaAppiumDriver::Driver) || self.instance_of?(::Selenium::WebDriver::Element) || self.instance_of?(::Appium::Core::Element)
+        args.last[:default_find_strategy] = @default_find_strategy
+        args.last[:default_scroll_strategy] = @default_scroll_strategy
+        if self.instance_of?(::Selenium::WebDriver::Element) || self.instance_of?(::Appium::Core::Element)
+          driver = self.get_driver
+        else
+          driver = self
+        end
+        Locator.new(driver, self, *args)
+      else
+        # class selector is executed from locator, just add child selector criteria
+        self.add_child_selector(*args)
+      end
+    end
+
+    # first element that match given selectors
+    # @param selectors [Hash]
+    # @return [TestaAppiumDriver::Locator] first element
+    def element(selectors = {})
+      unless selectors[:image].nil?
+        selectors[:strategy] = FIND_STRATEGY_IMAGE
+      end
+      add_selector(selectors)
+    end
+
+    # all elements that match given selectors
+    # @param params [Hash]
+    # @return [TestaAppiumDriver::Locator] all elements that match given selectors
+    def elements(params = {})
+      unless params[:image].nil?
+        params[:strategy] = FIND_STRATEGY_IMAGE
+      end
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # first android.widget.ImageView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def image_view(params = {})
+      params[:class] = "android.widget.ImageView"
+      add_selector(params)
+    end
+
+    # all android.widget.ImageView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def image_views(params = {})
+      params[:class] = "android.widget.ImageView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.FrameLayout element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def frame_layout(params = {})
+      params[:class] = "android.widget.FrameLayout"
+      add_selector(params)
+    end
+
+    # all android.widget.FrameLayout elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def frame_layouts(params = {})
+      params[:class] = "android.widget.FrameLayout"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.LinearLayout element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def linear_layout(params = {})
+      params[:class] = "android.widget.LinearLayout"
+      add_selector(params)
+    end
+
+    # all android.widget.LinearLayout elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def linear_layouts(params = {})
+      params[:class] = "android.widget.LinearLayout"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.view.View element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def view(params = {})
+      params[:class] = "android.view.View"
+      add_selector(params)
+    end
+
+    # all android.view.View elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def views(params = {})
+      params[:class] = "android.view.View"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.EditText element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def edit_text(params = {})
+      params[:class] = "android.widget.EditText"
+      add_selector(params)
+    end
+
+    # all android.widget.EditText elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def edit_texts(params = {})
+      params[:class] = "android.widget.EditText"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.view.ViewGroup element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def view_group(params = {})
+      params[:class] = "android.view.ViewGroup"
+      add_selector(params)
+    end
+
+    # all android.view.ViewGroup elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def view_groups(params = {})
+      params[:class] = "android.view.ViewGroup"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.RelativeLayout element that match given selecotrs
+    # @return [TestaAppiumDriver::Locator]
+    def relative_layout(params = {})
+      params[:class] = "android.widget.RelativeLayout"
+      add_selector(params)
+    end
+
+    # all android.widget.RelativeLayout elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def relative_layouts(params = {})
+      params[:class] = "android.widget.RelativeLayout"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first androidx.recyclerview.widget.RecyclerView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def recycler_view(params = {})
+      params[:class] = "androidx.recyclerview.widget.RecyclerView"
+      add_selector(params)
+    end
+
+    # all androidx.recyclerview.widget.RecyclerView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def recycler_views(params = {})
+      params[:class] = "androidx.recyclerview.widget.RecyclerView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.Button element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def button(params = {})
+      params[:class] = "android.widget.Button"
+      add_selector(params)
+    end
+
+    # all android.widget.Button elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def buttons(params = {})
+      params[:class] = "android.widget.Button"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.ImageButton element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def image_button(params = {})
+      params[:class] = "android.widget.ImageButton"
+      add_selector(params)
+    end
+
+    # all android.widget.ImageButton elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def image_buttons(params = {})
+      params[:class] = "android.widget.ImageButton"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.HorizontalScrollView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def horizontal_scroll_view(params = {})
+      params[:class] = "android.widget.HorizontalScrollView"
+      add_selector(params)
+    end
+
+    # all android.widget.HorizontalScrollView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def horizontal_scroll_views(params = {})
+      params[:class] = "android.widget.HorizontalScrollView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.ScrollView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def scroll_view(params = {})
+      params[:class] = "android.widget.ScrollView"
+      add_selector(params)
+    end
+
+    # all android.widget.ScrollView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def scroll_views(params = {})
+      params[:class] = "android.widget.ScrollView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first viewpager.widget.ViewPager element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def view_pager(params = {})
+      params[:class] = "androidx.viewpager.widget.ViewPager"
+      add_selector(params)
+    end
+
+    # all viewpager.widget.ViewPager elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def view_pagers(params = {})
+      params[:class] = "androidx.viewpager.widget.ViewPager"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.CheckBox element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def check_box(params = {})
+      params[:class] = "android.widget.CheckBox"
+      add_selector(params)
+    end
+
+    # all android.widget.CheckBox elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def check_boxes(params = {})
+      params[:class] = "android.widget.CheckBox"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.ListView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def list_view(params = {})
+      params[:class] = "android.widget.ListView"
+      add_selector(params)
+    end
+
+    # all android.widget.ListView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def list_views(params = {})
+      params[:class] = "android.widget.ListView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.ProgressBar element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def progress_bar(params = {})
+      params[:class] = "android.widget.ProgressBar"
+      add_selector(params)
+    end
+
+    # all android.widget.ProgressBar elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def progress_bars(params = {})
+      params[:class] = "android.widget.ProgressBar"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.RadioButton element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def radio_button(params = {})
+      params[:class] = "android.widget.RadioButton"
+      add_selector(params)
+    end
+
+    # all android.widget.RadioButton elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def radio_buttons(params = {})
+      params[:class] = "android.widget.RadioButton"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.RadioGroup element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def radio_group(params = {})
+      params[:class] = "android.widget.RadioGroup"
+      add_selector(params)
+    end
+
+    # all android.widget.RadioGroup elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def radio_groups(params = {})
+      params[:class] = "android.widget.RadioGroup"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.SearchView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def search_view(params = {})
+      params[:class] = "android.widget.SearchView"
+      add_selector(params)
+    end
+
+    # all android.widget.SearchView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def search_views(params = {})
+      params[:class] = "android.widget.SearchView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.Spinner element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def spinner(params = {})
+      params[:class] = "android.widget.Spinner"
+      add_selector(params)
+    end
+
+    # all android.widget.Spinner elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def spinners(params = {})
+      params[:class] = "android.widget.Spinner"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.Toast element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def toast(params = {})
+      params[:class] = "android.widget.Toast"
+      add_selector(params)
+    end
+
+    # all android.widget.Toast elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def toasts(params = {})
+      params[:class] = "android.widget.Toast"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.Toolbar element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def toolbar(params = {})
+      params[:class] = "android.widget.Toolbar"
+      add_selector(params)
+    end
+
+    # all android.widget.Toolbar elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def toolbars(params = {})
+      params[:class] = "android.widget.Toolbar"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.TextView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def text_view(params = {})
+      params[:class] = "android.widget.TextView"
+      add_selector(params)
+    end
+
+    # all android.widget.TextView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def text_views(params = {})
+      params[:class] = "android.widget.TextView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # first androidx.cardview.widget.CardView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def card_view(params = {})
+      params[:class] = "androidx.cardview.widget.CardView"
+      add_selector(params)
+    end
+
+    # all androidx.cardview.widget.CardView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def card_views(params = {})
+      params[:class] = "androidx.cardview.widget.CardView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # first android.widget.Switch element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def switch(params = {})
+      params[:class] = "android.widget.Switch"
+      add_selector(params)
+    end
+
+    # all android.widget.Switch elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def switches(params = {})
+      params[:class] = "android.widget.Switch"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # first android.webkit.WebView element that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def web_view(params = {})
+      params[:class] = "android.webkit.WebView"
+      add_selector(params)
+    end
+
+    # all android.webkit.WebView elements that match given selectors
+    # @return [TestaAppiumDriver::Locator]
+    def web_views(params = {})
+      params[:class] = "android.webkit.WebView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+  end
+end

data/lib/testa_appium_driver/android/driver.rb

@@ -0,0 +1,71 @@
+require_relative 'class_selectors'
+require_relative 'locator'
+require_relative 'scroll_actions/uiautomator_scroll_actions'
+require_relative 'selenium_element'
+
+module TestaAppiumDriver
+  class Driver
+    include ClassSelectors
+
+
+
+    # executes shell command
+    # @param [String] command Shell command name to execute for example echo or rm
+    # @param [Array<String>] args Array of command arguments, example: ['-f', '/sdcard/my_file.txt']
+    # @param [Integer] timeout Command timeout in milliseconds. If the command blocks for longer than this timeout then an exception is going to be thrown. The default timeout is 20000 ms
+    # @param [Boolean] includeStderr 	Whether to include stderr stream into the returned result.
+    def shell(command, args: nil, timeout: nil, includeStderr: true)
+      params = {
+          command: command,
+          includeStderr: includeStderr
+      }
+      params[:args] = args unless args.nil?
+      params[:timeout] = timeout unless timeout.nil?
+      @driver.execute_script("mobile: shell", params)
+    end
+
+
+    def scrollable
+      locator = Locator.new(self, self, {single: true})
+      locator.xpath_selector = "//androidx.recyclerview.widget.RecyclerView|//android.widget.ScrollView|//android.widget.ListView|//android.widget.HorizontalScrollView"
+      locator.ui_selector = "new UiSelector().scrollable(true).instance(0)"
+      locator
+    end
+
+
+    def scrollables
+      locator = Locator.new(self, self, {single: false})
+      locator.xpath_selector = "//androidx.recyclerview.widget.RecyclerView|//android.widget.ScrollView|//android.widget.ListView|//android.widget.HorizontalScrollView"
+      locator.ui_selector = "new UiSelector().scrollable(true)"
+      locator
+    end
+
+
+
+    private
+    def handle_testa_opts
+      if @testa_opts[:default_find_strategy].nil?
+        @default_find_strategy = DEFAULT_ANDROID_FIND_STRATEGY
+      else
+        case @testa_opts[:default_find_strategy].to_sym
+        when FIND_STRATEGY_UIAUTOMATOR, FIND_STRATEGY_XPATH
+          @default_find_strategy = @testa_opts[:default_find_strategy].to_sym
+        else
+          raise "Default find strategy #{@testa_opts[:default_find_strategy]} not supported for Android"
+        end
+      end
+
+
+      if @testa_opts[:default_scroll_strategy].nil?
+        @default_scroll_strategy = DEFAULT_ANDROID_SCROLL_STRATEGY
+      else
+        case @testa_opts[:default_scroll_strategy].to_sym
+        when SCROLL_STRATEGY_W3C, SCROLL_STRATEGY_UIAUTOMATOR
+          @default_scroll_strategy = @testa_opts[:default_scroll_strategy].to_sym
+        else
+          raise "Default scroll strategy #{@testa_opts[:default_scroll_strategy]} not supported for Android"
+        end
+      end
+    end
+  end
+end