testa_appium_driver 0.1.0

data/lib/testa_appium_driver/ios/driver.rb

@@ -0,0 +1,35 @@
+require_relative 'type_selectors'
+require_relative 'locator'
+require_relative 'selenium_element'
+
+module TestaAppiumDriver
+  class Driver
+    include TypeSelectors
+
+
+    def handle_testa_opts
+      if @testa_opts[:default_find_strategy].nil?
+        @default_find_strategy = DEFAULT_IOS_FIND_STRATEGY
+      else
+        case @testa_opts[:default_find_strategy].to_sym
+        when 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 iOS"
+        end
+      end
+
+
+      if @testa_opts[:default_scroll_strategy].nil?
+        @default_scroll_strategy = DEFAULT_IOS_SCROLL_STRATEGY
+      else
+        case @testa_opts[:default_scroll_strategy].to_sym
+        when SCROLL_STRATEGY_W3C
+          @default_scroll_strategy = @testa_opts[:default_scroll_strategy].to_sym
+        else
+          raise "Default scroll strategy #{@testa_opts[:default_scroll_strategy]} not supported for iOS"
+        end
+      end
+    end
+  end
+end

data/lib/testa_appium_driver/ios/locator.rb

@@ -0,0 +1,40 @@
+require_relative 'locator/attributes'
+
+module TestaAppiumDriver
+  #noinspection RubyTooManyInstanceVariablesInspection
+  class Locator
+    include TypeSelectors
+
+    def init(params, selectors, single)
+      if is_scrollable_selector?(selectors, single)
+        @scroll_orientation = :vertical
+        params[:scrollable_locator] = self.dup
+      end
+
+      @scrollable_locator = params[:scrollable_locator] if params[:scrollable_locator]
+    end
+
+
+    def selector
+      @xpath_selector
+    end
+
+
+    # @return [Locator] existing 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
+      add_xpath_child_selectors(locator, selectors, single)
+      if is_scrollable_selector?(selectors, single)
+        locator.scrollable_locator.scroll_orientation = :vertical
+        locator.scrollable_locator = self.dup
+      end
+
+      locator.last_selector_adjacent = false
+      locator
+    end
+  end
+end

data/lib/testa_appium_driver/ios/locator/attributes.rb

@@ -0,0 +1,79 @@
+module TestaAppiumDriver
+  #noinspection RubyYardReturnMatch
+  class Locator
+
+
+    #noinspection RubyNilAnalysis
+    def attribute(name, *args)
+      elements = execute(*args)
+
+      if elements.instance_of?(Selenium::WebDriver::Element)
+        r = elements.send(:attribute, name.to_s)
+        r = TestaAppiumDriver::Bounds.from_ios(r, @driver) if name.to_s == "rect"
+      else
+        r = elements.map { |e| e.send(:attribute, name.to_s) }
+        r.map! { |b| TestaAppiumDriver::Bounds.from_ios(b, @driver) } if name.to_s == "rect"
+      end
+      r
+    end
+
+
+    def accessibility_container(*args)
+      attribute("accessibilityContainer", *args)
+    end
+
+    def accessible?(*args)
+      attribute("accessible", *args).to_s == "true"
+    end
+
+
+    def class_name(*args)
+      attribute("class", *args)
+    end
+
+    def enabled?(*args)
+      attribute("enabled", *args).to_s == "true"
+    end
+
+    def frame(*args)
+      attribute("frame", *args)
+    end
+
+    def index(*args)
+      attribute("index", *args)
+    end
+
+    def label(*args)
+      attribute("label", *args)
+    end
+
+    def name(*args)
+      attribute("name", *args)
+    end
+
+
+    def rect(*args)
+      attribute("rect", *args)
+    end
+
+    def selected?(*args)
+      attribute("selected", *args).to_s == "true"
+    end
+
+    def type(*args)
+      attribute("type", *args)
+    end
+
+    def value(*args)
+      attribute("value", *args)
+    end
+
+    def visible?(*args)
+      attribute("visible", *args).to_s == "true"
+    end
+
+
+    alias_method :bounds, :rect
+    alias_method :text, :label
+  end
+end

data/lib/testa_appium_driver/ios/selenium_element.rb

@@ -0,0 +1,7 @@
+module Selenium
+  module WebDriver
+    class Element
+      include TestaAppiumDriver::TypeSelectors
+    end
+  end
+end

data/lib/testa_appium_driver/ios/type_selectors.rb

@@ -0,0 +1,167 @@
+module TestaAppiumDriver
+  #noinspection ALL
+  module TypeSelectors
+
+    # @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.kind_of(Selenium::WebDriver::Element)
+        args.last[:default_find_strategy] = @default_find_strategy
+        args.last[:default_scroll_strategy] = @default_scroll_strategy
+        Locator.new(self, self, *args)
+      else
+        # class selector is executed from locator, just add child selector criteria
+        self.add_child_selector(*args)
+      end
+    end
+
+    # @param selectors [Hash]
+    # @return [TestaAppiumDriver::Locator] first element
+    def element(selectors = {})
+      add_selector(selectors)
+    end
+
+    # @param params [Hash]
+    # @return [TestaAppiumDriver::Locator] all elements that match given selectors
+    def elements(params = {})
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # @return [TestaAppiumDriver::Locator]
+    def window(params = {})
+      params[:type] = "XCUIElementTypeWindow"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def windows(params = {})
+      params[:type] = "XCUIElementTypeWindow"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def other(params = {})
+      params[:type] = "XCUIElementTypeOther"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def others(params = {})
+      params[:type] = "XCUIElementTypeOther"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # @return [TestaAppiumDriver::Locator]
+    def navigation_bar(params = {})
+      params[:type] = "XCUIElementTypeNavigationBar"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def navigation_bars(params = {})
+      params[:type] = "XCUIElementTypeNavigationBar"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # @return [TestaAppiumDriver::Locator]
+    def button(params = {})
+      params[:type] = "XCUIElementTypeButton"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def buttons(params = {})
+      params[:type] = "XCUIElementTypeButton"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # @return [TestaAppiumDriver::Locator]
+    def image(params = {})
+      params[:type] = "XCUIElementTypeImage"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def images(params = {})
+      params[:type] = "XCUIElementTypeImage"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def static_text(params = {})
+      params[:type] = "XCUIElementTypeStaticText"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def static_texts(params = {})
+      params[:type] = "XCUIElementTypeStaticText"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # @param params [Hash]
+    # @return [TestaAppiumDriver::Locator] first scrollable element
+    def scrollable(params = {})
+      scroll_view(params)
+    end
+
+    # @param params [Hash]
+    # @return [TestaAppiumDriver::Locator] first scrollable element
+    def scrollables(params = {})
+      scroll_views(params)
+    end
+
+
+    # @return [TestaAppiumDriver::Locator]
+    def scroll_view(params = {})
+      params[:type] = "XCUIElementTypeScrollView"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def scroll_views(params = {})
+      params[:type] = "XCUIElementTypeScrollView"
+      params[:single] = false
+      add_selector(params)
+    end
+
+
+    # @return [TestaAppiumDriver::Locator]
+    def table(params = {})
+      params[:type] = "XCUIElementTypeTable"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def tables(params = {})
+      params[:type] = "XCUIElementTypeTable"
+      params[:single] = false
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def cell(params = {})
+      params[:type] = "XCUIElementTypeCell"
+      add_selector(params)
+    end
+
+    # @return [TestaAppiumDriver::Locator]
+    def cells(params = {})
+      params[:type] = "XCUIElementTypeCell"
+      params[:single] = false
+      add_selector(params)
+    end
+  end
+end

data/lib/testa_appium_driver/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module TestaAppiumDriver
+  VERSION = "0.1.0"
+end

data/testa_appium_driver.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "lib/testa_appium_driver/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "testa_appium_driver"
+  spec.version = TestaAppiumDriver::VERSION
+  spec.authors = ["karlo.razumovic"]
+  spec.email = ["karlo.razumovic@gmail.com"]
+
+  spec.summary = "Appium made easy"
+  spec.description = "Testa appium driver is a wrapper around ruby_lib_core. It significantly reduces the amount of code need to achieve your goals."
+  spec.homepage = "https://github.com/Karazum/testa_appium_driver"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.4.0"
+
+  #spec.metadata["allowed_push_host"] = "Set to 'https://mygemserver.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/Karazum/testa_appium_driver"
+  spec.metadata["changelog_uri"] = "https://github.com/Karazum/testa_appium_driver"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "appium_lib_core", ["= 4.7.0"]
+  spec.add_runtime_dependency "json", ["= 2.1.0"]
+
+  spec.add_development_dependency "rubocop", ["= 1.19.0"]
+  spec.add_development_dependency "rake", ["~> 13.0"]
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/testa_appium_driver.iml

@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="ruby-2.6.5-p114" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="appium_lib_core (v4.7.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.2, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.2.25, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="childprocess (v3.0.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="diff-lcs (v1.4.4, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="eventmachine (v1.2.7, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faye-websocket (v0.11.1, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json (v2.1.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.20.1, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parser (v3.0.2.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.0.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.0.6, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="regexp_parser (v2.1.1, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rexml (v3.2.5, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec (v3.10.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-core (v3.10.1, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-expectations (v3.10.1, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-mocks (v3.10.2, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-support (v3.10.2, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop (v1.19.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-ast (v1.10.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.11.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubyzip (v2.3.2, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="selenium-webdriver (v3.142.7, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v2.0.0, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="websocket-driver (v0.7.5, ruby-2.6.5-p114) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="websocket-extensions (v0.1.5, ruby-2.6.5-p114) [gem]" level="application" />
+  </component>
+  <component name="RakeTasksCache">
+    <option name="myRootTask">
+      <RakeTaskImpl id="rake">
+        <subtasks>
+          <RakeTaskImpl description="Build testa_appium_driver-0.1.0.gem into the pkg directory" fullCommand="build" id="build" />
+          <RakeTaskImpl id="build">
+            <subtasks>
+              <RakeTaskImpl description="Generate SHA512 checksum if testa_appium_driver-0.1.0.gem into the checksums directory" fullCommand="build:checksum" id="checksum" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
+          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
+          <RakeTaskImpl description="Build and install testa_appium_driver-0.1.0.gem into system gems" fullCommand="install" id="install" />
+          <RakeTaskImpl id="install">
+            <subtasks>
+              <RakeTaskImpl description="Build and install testa_appium_driver-0.1.0.gem into system gems without network access" fullCommand="install:local" id="local" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Create tag v0.1.0 and build and push testa_appium_driver-0.1.0.gem to rubygems.org" fullCommand="release[remote]" id="release[remote]" />
+          <RakeTaskImpl description="Run RuboCop" fullCommand="rubocop" id="rubocop" />
+          <RakeTaskImpl id="rubocop">
+            <subtasks>
+              <RakeTaskImpl description="Auto-correct RuboCop offenses" fullCommand="rubocop:auto_correct" id="auto_correct" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Run RSpec code examples" fullCommand="spec" id="spec" />
+          <RakeTaskImpl description="" fullCommand="default" id="default" />
+          <RakeTaskImpl description="" fullCommand="release" id="release" />
+          <RakeTaskImpl id="release">
+            <subtasks>
+              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
+              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
+              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
+            </subtasks>
+          </RakeTaskImpl>
+        </subtasks>
+      </RakeTaskImpl>
+    </option>
+  </component>
+</module>