appium_lib 11.2.0 → 12.0.0.rc4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3ba5b1acc654443b2c95f03d32d48ddbdb588c9050e7d8ca316885d89da7739
-  data.tar.gz: d25d035110db23ff212d478e79ebfd91298ff9d3d1195b2202c14313427520bf
+  metadata.gz: a8d7d7fcbce0bf73c13c462fa4cb83da298c19230d976ebff717684d56465e2d
+  data.tar.gz: fa87321a4d2bbf7647aa0683072fa20a6c40efc034dd778494e903acd06e7bf9
 SHA512:
-  metadata.gz: a2107113e9960ca8acab45a627293a75a9a6490eccb86241f009b75b023d1b3aa1591ac77233c8e6991dc189393f0371e13ce74c389e840edb07e4dc32df57f3
-  data.tar.gz: 9ea52aa96cfa2db86587a008479f54af58bd02b6cccf5c146b00161079f168a8733339cae61fbd733bb51b66d28177d44030d99f7c9a2e8c07f6415fe019b9c1
+  metadata.gz: 21e5285ece74a226157d0957f0dd49c9ea7207cb7c6296a8c2565c1dbae2ad771342c187c00a0bc989f33ea6c90e2370996cb5053d2257352f2a40ed9d9a7aab
+  data.tar.gz: 341f87e156a134a0ca6204299b9647f9d8f02ef07b5c68b16d54cd05b4b31abd7ee64f671ffdbb6a194ad060ea20eeb226ad5f590e4a69c3075e20df3c881000

data/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "11:00"
+  open-pull-requests-limit: 10

data/.github/workflows/rubocop.yml

@@ -11,7 +11,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: [2.4, 2.5, 2.6, 2.7, 3.0]
+        ruby: [2.6, 2.7, 3.0]
 
     runs-on: ubuntu-latest
 

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.4
+  TargetRubyVersion: 2.6
 Metrics/LineLength:
   Max: 128
 Metrics/MethodLength:
@@ -51,3 +51,91 @@ Style/StringConcatenation:
   Enabled: false
 Lint/NonDeterministicRequireOrder:
   Enabled: false
+Gemspec/DateAssignment:
+  Enabled: true
+Layout/LineEndStringConcatenationIndentation:
+  Enabled: true
+Layout/SpaceBeforeBrackets:
+  Enabled: true
+Lint/AmbiguousAssignment:
+  Enabled: true
+Lint/AmbiguousOperatorPrecedence:
+  Enabled: false
+Lint/AmbiguousRange:
+  Enabled: true
+Lint/DeprecatedConstants:
+  Enabled: true
+Lint/DuplicateBranch:
+  Enabled: true
+Lint/DuplicateRegexpCharacterClassElement:
+  Enabled: true
+Lint/EmptyBlock:
+  Enabled: true
+Lint/EmptyClass:
+  Enabled: false
+Lint/EmptyInPattern:
+  Enabled: true
+Lint/IncompatibleIoSelectWithFiberScheduler:
+  Enabled: true
+Lint/LambdaWithoutLiteralBlock:
+  Enabled: true
+Lint/NoReturnInBeginEndBlocks:
+  Enabled: true
+Lint/NumberedParameterAssignment:
+  Enabled: true
+Lint/OrAssignmentToConstant:
+  Enabled: true
+Lint/RedundantDirGlobSort:
+  Enabled: true
+Lint/RequireRelativeSelfPath:
+  Enabled: true
+Lint/SymbolConversion:
+  Enabled: true
+Lint/ToEnumArguments:
+  Enabled: true
+Lint/TripleQuotes:
+  Enabled: true
+Lint/UnexpectedBlockArity:
+  Enabled: true
+Lint/UnmodifiedReduceAccumulator:
+  Enabled: true
+Security/IoMethods:
+  Enabled: true
+Style/ArgumentsForwarding:
+  Enabled: true
+Style/CollectionCompact:
+  Enabled: true
+Style/DocumentDynamicEvalDefinition:
+  Enabled: true
+Style/EndlessMethod:
+  Enabled: true
+Style/HashConversion:
+  Enabled: false
+Style/HashExcept:
+  Enabled: true
+Style/IfWithBooleanLiteralBranches:
+  Enabled: true
+Style/InPatternThen:
+  Enabled: true
+Style/MultilineInPatternThen:
+  Enabled: true
+Style/NegatedIfElseCondition:
+  Enabled: true
+Style/NilLambda:
+  Enabled: true
+Style/NumberedParameters:
+  Enabled: true
+Style/NumberedParametersLimit:
+  Enabled: true
+Style/QuotedSymbols:
+  Enabled: true
+Style/RedundantArgument:
+  Enabled: true
+Style/RedundantSelfAssignmentBranch:
+  Enabled: true
+Style/SelectByRegexp:
+  Enabled: true
+Style/StringChars:
+  Enabled: true
+Style/SwapValues:
+  Enabled: true

data/CHANGELOG.md

@@ -7,9 +7,22 @@ Release tags are https://github.com/appium/ruby_lib/releases .
 
 ### 1. Enhancements
 
-### 2. Bug fixes
-
-## 11.1.0 - 2020-12-29
+- Update base [ruby_lib_core client](https://github.com/appium/ruby_lib_core) to v5
+    - Update base selenium webdriver version to `4.0.0`
+        - Support only W3C spec as following Selenium v4 client
+        - Support Ruby 2.6+
+    - `element.id` returns the element id instead of `element.ref`. `element.ref` now returns an array.
+    - Removed `forceMjsonwp` to send only MJSONWP capabilities since Selenium cleint v4 no longer supports MJSONWP
+    - No longer set default `timeouts` as `0`. ruby_lib_core calls `/timeouts` endpoint only when `appium_lib: { wait: 5 }` is provided explicitly
+    - Raises `::Appium::Core::Error::ArgumentError` instead of `ArgumentError` for this library specific argument errors
+
+### 2. Deprecations
+- `TouchAction` and `MultiTouch` are deprecated
+    - Please use W3C actions instead https://github.com/appium/ruby_lib/blob/master/docs/w3c.md
+    - Other examples: https://github.com/appium/ruby_lib/pull/909
+- Removed Selendroid related methods
+
+## 11.1.0 - 2020-12-29 (11.2.0 is the same as this version)
 
 Support Ruby 3
 
@@ -105,7 +118,7 @@ This change has a breaking change about implicit wait.
 - **Breaking changes**
     - Set implicit wait zero by default following [WebDriver spec in Selenium](https://www.seleniumhq.org/docs/04_webdriver_advanced.jsp)
         - The change potentially break your `find_element/s`
-        - You can wrap it with `wait` method to avoid the error explicitly 
+        - You can wrap it with `wait` method to avoid the error explicitly
         - Or you also can configure `wait: 20` as `appium_lib` capability to keep the behaviour
 - [Experimental]
     - Add `direct_connect` capability
@@ -162,7 +175,7 @@ This change has a breaking change about implicit wait.
       { platformName: :windows,
         app: 'relative/path/to/app'
       }
-    } # `:app` will be alsolute path to the `:app` if the path exists    
+    } # `:app` will be alsolute path to the `:app` if the path exists
     ```
 
 ### 3. Deprecations
@@ -312,7 +325,7 @@ This change has a breaking change about implicit wait.
 ## v9.9.0
 ### 1. Enhancements
 - Bump the core library to 1.3.0
-    - The change have one breaking change for `start_recording_screen`(Android) 
+    - The change have one breaking change for `start_recording_screen`(Android)
     - Read `docs/migration.md`
 
 ### 2. Bug fixes

data/appium_lib.gemspec

@@ -1,7 +1,7 @@
 require_relative 'lib/appium_lib/version'
 
 Gem::Specification.new do |s|
-  s.required_ruby_version = '>= 2.4'
+  s.required_ruby_version = '>= 2.6'
 
   s.name          = 'appium_lib'
   s.version       = Appium::VERSION
@@ -14,17 +14,17 @@ Gem::Specification.new do |s|
   s.homepage      = 'https://github.com/appium/ruby_lib' # published as appium_lib
   s.require_paths = ['lib']
 
-  s.add_runtime_dependency 'appium_lib_core', '~> 4.1'
+  s.add_runtime_dependency 'appium_lib_core', '5.0.0.rc8'
   s.add_runtime_dependency 'nokogiri', '~> 1.8', '>= 1.8.1'
-  s.add_runtime_dependency 'tomlrb', '~> 1.1'
+  s.add_runtime_dependency 'tomlrb', '>= 1.1', '< 3.0'
 
   s.add_development_dependency 'appium_thor', '~> 1.1', '>= 1.1.4'
-  s.add_development_dependency 'fakefs', '~> 1.3.0'
+  s.add_development_dependency 'fakefs', '~> 1.4.0'
   s.add_development_dependency 'hashdiff', '~> 1.0.0'
   s.add_development_dependency 'posix-spawn', '~> 0.3'
   s.add_development_dependency 'pry'
   s.add_development_dependency 'rake', '~> 13.0'
-  s.add_development_dependency 'rubocop', '1.8.1'
+  s.add_development_dependency 'rubocop', '1.22.3'
   s.add_development_dependency 'spec', '~> 5.3', '>= 5.3.4'
   s.add_development_dependency 'yard', '~> 0.9.11'
 

data/lib/appium_lib/android/common/helper.rb

@@ -234,11 +234,11 @@ module Appium
 
       if class_name == '*'
         return "//*[contains(translate(@text,'#{value.upcase}', '#{value}'), '#{value}')" \
-          " or contains(translate(@content-desc,'#{value.upcase}', '#{value}'), '#{value}')" + r_id + ']'
+               " or contains(translate(@content-desc,'#{value.upcase}', '#{value}'), '#{value}')" + r_id + ']'
       end
 
       "//#{class_name}[contains(translate(@text,'#{value.upcase}', '#{value}'), '#{value}')" \
-        " or contains(translate(@content-desc,'#{value.upcase}', '#{value}'), '#{value}')" + r_id + ']'
+      " or contains(translate(@content-desc,'#{value.upcase}', '#{value}'), '#{value}')" + r_id + ']'
     end
 
     # Returns a string that matches the first element that contains value

data/lib/appium_lib/android/element/button.rb

@@ -98,10 +98,10 @@ module Appium
 
       if button_index && image_button_index
         "new UiSelector().className(#{BUTTON}).instance(#{button_index});" \
-        "new UiSelector().className(#{IMAGE_BUTTON}).instance(#{image_button_index});"
+          "new UiSelector().className(#{IMAGE_BUTTON}).instance(#{image_button_index});"
       else
         "new UiSelector().className(#{BUTTON});" \
-        "new UiSelector().className(#{IMAGE_BUTTON});"
+          "new UiSelector().className(#{IMAGE_BUTTON});"
       end
     end
 

data/lib/appium_lib/android/element/generic.rb

@@ -56,12 +56,10 @@ module Appium
       rid  = resource_id(text, "new UiSelector().resourceId(#{text})")
       args = rid.empty? ? ["new UiSelector().textContains(#{text})", "new UiSelector().descriptionContains(#{text})"] : [rid]
       args.each_with_index do |arg, index|
-        begin
-          elem = find_element :uiautomator, scroll_uiselector(arg, scrollable_index)
-          return elem
-        rescue StandardError => e
-          raise e if index == args.size - 1
-        end
+        elem = find_element :uiautomator, scroll_uiselector(arg, scrollable_index)
+        return elem
+      rescue StandardError => e
+        raise e if index == args.size - 1
       end
     end
 
@@ -74,12 +72,10 @@ module Appium
       rid  = resource_id(text, "new UiSelector().resourceId(#{text})")
       args = rid.empty? ? ["new UiSelector().text(#{text})", "new UiSelector().description(#{text})"] : [rid]
       args.each_with_index do |arg, index|
-        begin
-          elem = find_element :uiautomator, scroll_uiselector(arg, scrollable_index)
-          return elem
-        rescue StandardError => e
-          raise e if index == args.size - 1
-        end
+        elem = find_element :uiautomator, scroll_uiselector(arg, scrollable_index)
+        return elem
+      rescue StandardError => e
+        raise e if index == args.size - 1
       end
     end
   end # module Android

data/lib/appium_lib/android/espresso/element/generic.rb

@@ -25,19 +25,17 @@ module Appium
           w_s = window_rect
 
           (1..30).each do |_count|
-            begin
-              action
-                .move_to_location(w_s.width / 2, (w_s.height * 2) / 5) # pointer based magic number
-                .pointer_down(:left)
-                .move_to_location(0, w_s.height / 5)
-                .release
-                .perform
-              sleep 1 # we must wait finish scrolling
+            action
+              .move_to_location(w_s.width / 2, (w_s.height * 2) / 5) # pointer based magic number
+              .pointer_down(:left)
+              .move_to_location(0, w_s.height / 5)
+              .release
+              .perform
+            sleep 1 # we must wait finish scrolling
 
-              return text(text)
-            rescue StandardError => e
-              err = e
-            end
+            return text(text)
+          rescue StandardError => e
+            err = e
           end
 
           raise err
@@ -52,19 +50,17 @@ module Appium
           w_s = window_rect
 
           (1..30).each do |_count|
-            begin
-              action
-                .move_to_location(w_s.width / 2, (w_s.height * 2) / 5) # pointer based magic number
-                .pointer_down(:left)
-                .move_to_location(0, w_s.height / 5)
-                .release
-                .perform
-              sleep 1 # we must wait finish scrolling
+            action
+              .move_to_location(w_s.width / 2, (w_s.height * 2) / 5) # pointer based magic number
+              .pointer_down(:left)
+              .move_to_location(0, w_s.height / 5)
+              .release
+              .perform
+            sleep 1 # we must wait finish scrolling
 
-              return text_exact(text)
-            rescue StandardError => e
-              err = e
-            end
+            return text_exact(text)
+          rescue StandardError => e
+            err = e
           end
 
           raise err

data/lib/appium_lib/android/uiautomator2/element/button.rb

@@ -101,10 +101,10 @@ module Appium
 
           if button_index && image_button_index
             "new UiSelector().className(#{::Appium::Android::Button}).instance(#{button_index});" \
-        "new UiSelector().className(#{::Appium::Android::ImageButton}).instance(#{image_button_index});"
+              "new UiSelector().className(#{::Appium::Android::ImageButton}).instance(#{image_button_index});"
           else
             "new UiSelector().className(#{::Appium::Android::Button});" \
-        "new UiSelector().className(#{::Appium::Android::ImageButton});"
+              "new UiSelector().className(#{::Appium::Android::ImageButton});"
           end
         end
 

data/lib/appium_lib/appium.rb

@@ -156,18 +156,16 @@ module Appium
 
       target_modules.each do |const|
         # noinspection RubyResolve
-        # rubocop:disable Style/MultilineIfModifier
         driver.public_methods(false).each do |m|
+          # override unless there's an existing method with matching arity
+          next if const.respond_to?(m) && const.method(m).arity == driver.method(m).arity
+
           const.send(:define_singleton_method, m) do |*args, &block|
-            begin
-              super(*args, &block) # promote.rb
-            rescue NoMethodError, ArgumentError
-              driver.send m, *args, &block if driver.respond_to?(m)
-            end
-            # override unless there's an existing method with matching arity
-          end unless const.respond_to?(m) && const.method(m).arity == driver.method(m).arity
+            super(*args, &block) # promote.rb
+          rescue NoMethodError, ArgumentError
+            driver.send m, *args, &block if driver.respond_to?(m)
+          end
         end
-        # rubocop:enable Style/MultilineIfModifier
       end
     end
 
@@ -210,23 +208,21 @@ module Appium
             end
 
             define_method method do |*args, &block|
-              begin
-                # Prefer existing method.
-                # super will invoke method missing on driver
-                super(*args, &block)
-
-                # minitest also defines a name method,
-                # so rescue argument error
-                # and call the name method on $driver
-              rescue NoMethodError, ArgumentError
-                if args.size == 1 && args.first.is_a?(Hash)
-                  # To prevent warnings by keyword arguments (for Ruby 2.7 and 3)
-                  driver.send method, **args.first, &block if driver.respond_to?(method)
-                else
-                  ::Appium::Logger.warn "Should fix this '#{args}' for Ruby 2.7 (and 3)" if args.first.is_a?(Hash)
-
-                  driver.send method, *args, &block if driver.respond_to?(method)
-                end
+              # Prefer existing method.
+              # super will invoke method missing on driver
+              super(*args, &block)
+
+              # minitest also defines a name method,
+              # so rescue argument error
+              # and call the name method on $driver
+            rescue NoMethodError, ArgumentError
+              if args.size == 1 && args.first.is_a?(Hash)
+                # To prevent warnings by keyword arguments (for Ruby 2.7 and 3)
+                driver.send method, **args.first, &block if driver.respond_to?(method)
+              else
+                ::Appium::Logger.warn "Should fix this '#{args}' for Ruby 2.7 (and 3)" if args.first.is_a?(Hash)
+
+                driver.send method, *args, &block if driver.respond_to?(method)
               end
             end
           end

data/lib/appium_lib/common/wait.rb

@@ -42,7 +42,7 @@ module Appium
     #     wait_true(20) { button_exact('Back') }.click
     #
     def wait_true(opts = {})
-      opts = opts.is_a?(Numeric) ? { timeout: opts } : opts
+      opts = { timeout: opts } if opts.is_a? Numeric
 
       if opts.is_a? Hash
         opts.empty? ? @core.wait_true { yield } : @core.wait_true(**opts) { yield }
@@ -71,8 +71,7 @@ module Appium
     #     wait(20) { button_exact('Back') }.click
     #
     def wait(opts = {})
-      opts = opts.is_a?(Numeric) ? { timeout: opts } : opts
-
+      opts = { timeout: opts } if opts.is_a? Numeric
       if opts.is_a? Hash
         opts.empty? ? @core.wait { yield } : @core.wait(**opts) { yield }
       else

data/lib/appium_lib/driver.rb

@@ -151,18 +151,10 @@ module Appium
     # @param opts [Object] A hash containing various options.
     # @param global_driver [Bool] A bool require global driver before initialize.
     # @return [Driver]
-    def initialize(opts = {}, global_driver = nil)
-      # TODO: set `global_driver = false` by default in the future.
+    def initialize(opts = {}, global_driver = false)
       # Capybara can't put `global_driver` as the 2nd argument.
       global_driver = opts.delete :global_driver if global_driver.nil?
 
-      if global_driver.nil?
-        warn '[DEPRECATION] Appium::Driver.new(opts) will not generate global driver by default.' \
-                 'If you would like to generate the global driver dy default, ' \
-                 'please initialise driver with Appium::Driver.new(opts, true)'
-        global_driver = true # if global_driver is nil, then global_driver must be default value.
-      end
-
       $driver&.driver_quit if global_driver
 
       raise 'opts must be a hash' unless opts.is_a? Hash
@@ -325,27 +317,7 @@ module Appium
       !@core.automation_name.nil? && @core.automation_name == :xcuitest
     end
 
-    # Get the dialect value whether current driver is OSS or W3C
-    #
-    # @return [:oss | :w3c]
-    #
-    #  @example
-    #
-    #      if dialect == :w3c
-    #        driver.action
-    #              .move_to_location(500, 500).pointer_down(:left)
-    #              .move_to_location(0, 700)
-    #              .release.perform
-    #      else
-    #        action = TouchAction.new(driver).press(x: 500, y: 500).move_to(500, 700).release
-    #        action.perform
-    #      end
-    #
-    def dialect
-      @driver.dialect
-    end
-
-    # An entry point to chain W3C actions. Returns `TouchAction.new` if it works as MJSONWP instead of W3C action.
+    # An entry point to chain W3C actions
     # Read https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Base/Bridge/W3C#action-instance_method
     #
     # @return [TouchAction|Selenium::WebDriver::PointerActions]
@@ -356,12 +328,7 @@ module Appium
     #     action.click(element).perform # The `click` is a part of `PointerActions`
     #
     def action
-      if @driver.dialect != :w3c
-        ::Appium::Logger.info('Calls TouchAction instead of W3C actions for MJSONWP module')
-        TouchAction.new($driver || @driver)
-      else
-        @driver.action
-      end
+      @driver.action
     end
 
     # Returns the server's version info
@@ -815,7 +782,9 @@ module Appium
     end
 
     def log_event=(log_event)
-      raise ArgumentError('log_event should be Hash like { vendor: "appium", event: "funEvent"}') unless log_event.is_a?(Hash)
+      unless log_event.is_a?(Hash)
+        raise ::Appium::Core::Error::ArgumentError('log_event should be Hash like { vendor: "appium", event: "funEvent"}')
+      end
 
       @driver.logs.event vendor: log_event[:vendor], event: log_event[:event]
     end

data/lib/appium_lib/ios/xcuitest/command/gestures.rb

@@ -24,7 +24,7 @@ module Appium
         #   ```
         def swipe(direction:, element: nil)
           args = { direction: direction }
-          args[:element] = element.ref if element
+          args[:element] = element.id if element
 
           @driver.execute_script 'mobile: swipe', args
         end
@@ -47,7 +47,7 @@ module Appium
           return 'Set "up", "down", "left" or "right" for :direction' unless %w(up down left right).include?(direction)
 
           args = { direction: direction }
-          args[:element] = element.ref if element
+          args[:element] = element.id if element
           args[:distance] = distance if distance
           args[:name] = name if name
           args[:toVisible] = to_visible if to_visible
@@ -66,7 +66,7 @@ module Appium
         #   ```
         def pinch(scale:, velocity: 1.0, element: nil)
           args = { scale: scale, velocity: velocity }
-          args[:element] = element.ref if element
+          args[:element] = element.id if element
 
           @driver.execute_script 'mobile: pinch', args
         end
@@ -82,7 +82,7 @@ module Appium
         def double_tap(x: nil, y: nil, element: nil)
           return 'Set x, y or element' if (x.nil? || y.nil?) && element.nil?
 
-          args = element.nil? ? { x: x, y: y } : { element: element.ref }
+          args = element.nil? ? { x: x, y: y } : { element: element.id }
           @driver.execute_script 'mobile: doubleTap', args
         end
 
@@ -99,7 +99,7 @@ module Appium
         def touch_and_hold(x: nil, y: nil, element: nil, duration: 1.0)
           return 'Set x, y or element' if (x.nil? || y.nil?) && element.nil?
 
-          args = element.nil? ? { x: x, y: y } : { element: element.ref }
+          args = element.nil? ? { x: x, y: y } : { element: element.id }
           args[:duration] = duration
           @driver.execute_script 'mobile: touchAndHold', args
         end
@@ -110,7 +110,7 @@ module Appium
         #   two_finger_tap element: find_element(:accessibility_id, "some item")
         #   ```
         def two_finger_tap(element:)
-          args = { element: element.ref }
+          args = { element: element.id }
           @driver.execute_script 'mobile: twoFingerTap', args
         end
 
@@ -126,7 +126,7 @@ module Appium
         #   ```
         def one_finger_tap(x:, y:, element: nil)
           args = { x: x, y: y }
-          args[:element] = element.ref if element
+          args[:element] = element.id if element
           @driver.execute_script 'mobile: tap', args
         end
 
@@ -146,7 +146,7 @@ module Appium
         #   ```
         def drag_from_to_for_duration(from_x:, from_y:, to_x:, to_y:, duration: 1.0, element: nil)
           args = { fromX: from_x, fromY: from_y, toX: to_x, toY: to_y, duration: duration }
-          args[:element] = element.ref if element
+          args[:element] = element.id if element
           @driver.execute_script 'mobile: dragFromToForDuration', args
         end
         # rubocop:enable Metrics/ParameterLists
@@ -164,7 +164,7 @@ module Appium
         def select_picker_wheel(element:, order:, offset: nil)
           return 'Set "next" or "previous" for :order' unless %w(next previous).include?(order)
 
-          args = { element: element.ref, order: order }
+          args = { element: element.id, order: order }
           args[:offset] = offset if offset
           @driver.execute_script 'mobile: selectPickerWheelValue', args
         end

data/lib/appium_lib/version.rb

@@ -14,6 +14,6 @@
 
 module Appium
   # Version and Date are defined on the 'Appium' module, not 'Appium::Common'
-  VERSION = '11.2.0' unless defined? ::Appium::VERSION
-  DATE    = '2021-01-25' unless defined? ::Appium::DATE
+  VERSION = '12.0.0.rc4' unless defined? ::Appium::VERSION
+  DATE    = '2021-11-01' unless defined? ::Appium::DATE
 end

data/readme.md

@@ -21,9 +21,11 @@ We can avoid the class driver with current `ruby_lib`, but if you'd like to impl
 # Setup
 ## Requirement
 - [Appium](https://github.com/appium/appium#requirements)
-- Ruby: 2.4+
+- Ruby: 2.6+
 
 ### Ruby Lib and Appium
+
+- Ruby library version over `12.0.0` is based on Selenium v4
 - Ruby library version over `9.8.0` requires Appium over `1.8`
 - Ruby library version under `9.7.5` can work with Appium under `1.7`
 
@@ -35,16 +37,9 @@ $ appium
 ```
 
 ## Install / Upgrade
-- Update rubygems and bundler
-```bash
-$ gem update --system
-$ gem update bundler
-```
 
-- Install the latest gem release
 ```bash
-gem uninstall -aIx appium_lib
-gem install --no-rdoc --no-ri appium_lib
+gem install appium_lib
 ```
 
 ## [Sauce Labs env vars](https://github.com/appium/ruby_lib/blob/master/lib/appium_lib/sauce_labs.rb)

metadata

@@ -1,30 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 11.2.0
+  version: 12.0.0.rc4
 platform: ruby
 authors:
 - code@bootstraponline.com
 - Kazuaki Matsuo
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-25 00:00:00.000000000 Z
+date: 2021-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appium_lib_core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: 5.0.0.rc8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: 5.0.0.rc8
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -49,16 +49,22 @@ dependencies:
   name: tomlrb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: appium_thor
   requirement: !ruby/object:Gem::Requirement
@@ -85,14 +91,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: hashdiff
   requirement: !ruby/object:Gem::Requirement
@@ -155,14 +161,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: 1.22.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: 1.22.3
 - !ruby/object:Gem::Dependency
   name: spec
   requirement: !ruby/object:Gem::Requirement
@@ -208,6 +214,7 @@ files:
 - ".azure-pipelines.yml"
 - ".github/ISSUE_TEMPLATE.md"
 - ".github/PULL_REQUEST_TEMPLATE.md"
+- ".github/dependabot.yml"
 - ".github/workflows/rubocop.yml"
 - ".gitignore"
 - ".rubocop.yml"
@@ -221,12 +228,10 @@ files:
 - docs/android_docs.md
 - docs/android_uiautomator.md
 - docs/docs.md
-- docs/index_paths.md
 - docs/ios_docs.md
 - docs/ios_xcuitest.md
 - docs/migration.md
 - docs/parallel.md
-- docs/travis.sample.yml
 - docs/w3c.md
 - lib/appium_lib.rb
 - lib/appium_lib/android/android.rb
@@ -290,7 +295,7 @@ homepage: https://github.com/appium/ruby_lib
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -298,15 +303,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Ruby library for Appium
 test_files: []

data/docs/index_paths.md

@@ -1,26 +0,0 @@
-**Deprecated** Because iOS driver for UIAutomation is deprecated.
-
-# Index Paths on iOS
-
-Elements on iOS have an [index path attribute](https://github.com/appium/appium-uiauto/blob/2cf1e30801263dfc01627ded28a1be5af1083bc5/uiauto/lib/element-patch/tree-patch.js#L9)
-that appium calculates when the page source is requested. Note this is not the same as xpath.
-
-> <UIAStaticText name="Alerts" label="Alerts" value="Alerts" dom="" enabled="true" valid="true" visible="true" hint="" path="/0/1/1/10/0" x="17.578125" y="596" width="53.90625" height="25.78125">
-
-The index path can be used by calling [getElementByIndexPath]( https://github.com/appium/appium-uiauto/blob/af1befa8208074686cd38b845ddefabc057106fc/uiauto/lib/mechanic-ext/xpath-ext.js#L239):
-
-```ruby
-# ruby example # For Appium(automation name), not XCUITest
-execute_script('$.getElementByIndexPath("/0/1/1/10/0")').text # Alerts
-```
-
-Internally what happens is `/0/1/1/10/0` is transformed into `1/1/10/0` and executed as follows:
-
-```ruby
-# ruby example # For Appium(automation name), not XCUITest
-execute_script('$.mainApp().elements()[1].elements()[1].elements()[10].elements()[0]').text # Alerts
-```
-
-The initial 0 refers to the context so that's [discarded](https://github.com/appium/appium-uiauto/blob/af1befa8208074686cd38b845ddefabc057106fc/uiauto/lib/mechanic-ext/xpath-ext.js#L218).
-
-In summary, you shouldn't try and convert the index path to an xpath. It's meant to be used via the built in helper method.

data/docs/travis.sample.yml

@@ -1,24 +0,0 @@
-language: objective-c
-sudo: false
-osx_image: xcode8.3
-
-cache: bundler
-
-rvm:
-  - 2.4
-
-install:
-  - bundle install
-  - npm install -g appium@1.6.4
-
-before_script:
-  - appium --log-level warn &
-
-script:
-  - bundle exec rake rubocop
-  - cd ios_tests; rake ios
-
-notifications:
-  email:
-    on_success: never
-    on_failure: never