appium_lib 15.1.0 → 15.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 796adeac9cf88dc053e753f5247424776c3fc76e7315faab0707a701b51626d1
-  data.tar.gz: 324af242f927a23024b497aa8ecbedd68dc83553473b2901e3a6dfc2da01849a
+  metadata.gz: 750c26700d454f0c25763e97ee928a5444179c44e78cec36376d45e5abf44719
+  data.tar.gz: 7d3e581164f1c57ce7b49b332daf8f105fbd7ff0968b14095bc4fd99feff5a41
 SHA512:
-  metadata.gz: '065363852318ced51ba308b9bc4b9708b66650d746e840f672721e58ae8a32351fd4be26df57f78794ba23f5de98ed22af77fceafeccf38cb80b3efc7545ab2e'
-  data.tar.gz: c03a4fd8b6966e60fd65fc33202a07a6fd4220f57eac3220acc82e8d33ec3562ccfa520ffc18996ac7758ba5019939320393733ad48c543371816788f67c36c2
+  metadata.gz: 1a1129d4f761e5fca9960ec3963bb62554fc623e91948aaf67f50e3357492fa5e9fbc678ee62513802b1dc345866c56c69e88e6fc45c9a431a1890e9167f0783
+  data.tar.gz: 3863036c2f319fbc4943ace7158838dd88ba47535b05e18b950a987d7d08250711a32cdd57a5cbb046e389a4399e3bffc00951722d8095737dbfa3204228a873

data/.github/workflows/functional-test.yml

@@ -0,0 +1,77 @@
+name: Functional Tests
+
+on:
+  # Run by manual at this time
+  workflow_dispatch:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ios_test:
+    runs-on: macos-14
+    env:
+          XCODE_VERSION: 15.3
+          IOS_VERSION: 17.4
+          IOS_DEVICE_NAME: iPhone 15 Plus
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Install Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: 'lts/*'
+
+    - name: Select Xcode
+      uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: ${{ env.XCODE_VERSION }}
+    - run: defaults write com.apple.iphonesimulator PasteboardAutomaticSync -bool false
+
+    - uses: futureware-tech/simulator-action@v3
+      with:
+      # https://github.com/actions/runner-images/blob/main/images/macos/macos-14-arm64-Readme.md
+        model: ${{ env.IOS_DEVICE_NAME }}
+        os_version: ${{ env.IOS_VERSION }}
+
+    - name: Preparing other environment
+      run: |
+        brew install ffmpeg
+        brew tap wix/brew
+        brew install applesimutils
+
+    # Start Appium
+    - name: Install appium and mjpeg-consumer
+      run: |
+        npm install -g appium
+        npm install -g mjpeg-consumer
+    - run: |
+        appium driver install xcuitest
+        appium plugin install images@2.1.8
+        appium plugin install execute-driver
+        nohup appium --use-plugins=images,execute-driver --relaxed-security --log-timestamp --log-no-colors --base-path=/wd/hub > appium.log &
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.2
+    - run: |
+        bundle install
+        rake ios
+      name: Run tests
+      working-directory: ios_tests
+
+    - name: Save server output
+      if: ${{ always() }}
+      uses: actions/upload-artifact@master
+      with:
+        name: appium-ios_test_with_other_deps.log
+        path: |
+          appium.log
+          test/report/

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 3.0
 Metrics/LineLength:
   Max: 128
 Metrics/MethodLength:

data/CHANGELOG.md

@@ -3,8 +3,14 @@ Commit based release not is [release_notes.md](./release_notes.md)
 
 Release tags are https://github.com/appium/ruby_lib/releases .
 
+## 15.2.1 - 2024-08-03
+- Fix client side timeout in the default http client
+- Bump appium_lib_core 9.2.1+ to apply the fix
 
-## [15.1.0] - 2024-05-19
+## 15.2.0 - 2024-07-20
+- Raise defined errors instead of Ruby general errors by appium_lib's own errors
+
+## 15.1.0 - 2024-05-19
 - Use appium_lib_core 9.0.0
 
 ## 15.0.1 - 2024-04-26

data/appium_lib.gemspec

@@ -13,7 +13,7 @@ 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', '~> 9.0'
+  s.add_runtime_dependency 'appium_lib_core', '~> 9.2', '>= 9.2.1'
   s.add_runtime_dependency 'nokogiri', '~> 1.8', '>= 1.8.1'
   s.add_runtime_dependency 'tomlrb', '>= 1.1', '< 3.0'
 
@@ -24,7 +24,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency 'minitest-reporters', '~> 1.1'
   s.add_development_dependency 'pry'
   s.add_development_dependency 'rake', '~> 13.0'
-  s.add_development_dependency 'rubocop', '1.63.5'
+  s.add_development_dependency 'rubocop', '1.65.1'
   s.add_development_dependency 'yard', '~> 0.9.11'
 
   s.files = `git ls-files`.split("\n").reject { |v| v.match(/\A^(ios_tests|android_tests|grid|test_apps)\/.+/) }

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

@@ -150,7 +150,7 @@ module Appium
         index = results.length
         index -= 1 if index >= 0
       else
-        raise 'Index must be >= 1' unless index >= 1
+        raise ArgumentError, 'Index must be >= 1' unless index >= 1
 
         index -= 1 if index >= 1
       end

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

@@ -29,7 +29,7 @@ module Appium
       # Android needs to combine button and image button to match iOS.
       if value.is_a? Numeric
         index = value
-        raise "#{index} is not a valid index. Must be >= 1" if index <= 0
+        raise ArgumentError, "#{index} is not a valid index. Must be >= 1" if index <= 0
 
         # 1 indexed
         return find_element :uiautomator, _button_visible_selectors(index: index)

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

@@ -25,7 +25,7 @@ module Appium
           # Android needs to combine button and image button to match iOS.
           if value.is_a? Numeric
             index = value
-            raise "#{index} is not a valid index. Must be >= 1" if index <= 0
+            raise ArgumentError, "#{index} is not a valid index. Must be >= 1" if index <= 0
 
             # zero index
             _button_visible_selectors_xpath(index: index - 1)

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

@@ -25,7 +25,7 @@ module Appium
           # Android needs to combine button and image button to match iOS.
           if value.is_a? Numeric
             index = value
-            raise "#{index} is not a valid index. Must be >= 1" if index <= 0
+            raise ArgumentError, "#{index} is not a valid index. Must be >= 1" if index <= 0
 
             result = find_elements :uiautomator, _button_visible_selectors(index: index)
             raise _no_such_element if result.empty?

data/lib/appium_lib/appium.rb

@@ -56,11 +56,11 @@ module Appium
     # @param opts [Hash] file: '/path/to/appium.txt', verbose: true
     # @return [hash] the symbolized hash with updated :app and :require keys
     def load_settings(opts = {})
-      raise 'opts must be a hash' unless opts.is_a? Hash
-      raise 'opts must not be empty' if opts.empty?
+      raise ArgumentError, 'opts must be a hash' unless opts.is_a? Hash
+      raise ArgumentError, 'opts must not be empty' if opts.empty?
 
       toml = opts[:file]
-      raise 'Must pass a capability file which has [caps] and [appium_lib]' unless toml
+      raise ArgumentError, 'Must pass a capability file which has [caps] and [appium_lib]' unless toml
 
       verbose = opts.fetch :verbose, false
 
@@ -69,7 +69,7 @@ module Appium
       toml_exists = File.exist? toml
       Appium::Logger.info "Exists? #{toml_exists}" if verbose
 
-      raise "toml doesn't exist #{toml}" unless toml_exists
+      raise ArgumentError, "toml doesn't exist #{toml}" unless toml_exists
 
       require 'tomlrb'
       Appium::Logger.info "Loading #{toml}" if verbose
@@ -151,7 +151,7 @@ module Appium
     # @param [Array<Module>] modules An array of modules
     # @param [Driver] driver A driver to extend for
     def promote_singleton_appium_methods(modules, driver = $driver)
-      raise 'Global $driver is nil' if driver.nil?
+      raise ArgumentError, 'Global $driver is nil' if driver.nil?
 
       target_modules = []
 
@@ -160,7 +160,7 @@ module Appium
           target_modules << modules.const_get(sub_module)
         end
       else
-        raise 'modules must be a module or an array' unless modules.is_a? Array
+        raise ArgumentError, 'modules must be a module or an array' unless modules.is_a? Array
 
         target_modules = modules
       end
@@ -205,7 +205,7 @@ module Appium
     #   Appium.promote_appium_methods Minitest::Spec
     #
     def promote_appium_methods(class_array, driver = $driver)
-      raise 'Driver is nil' if driver.nil?
+      raise ArgumentError, 'Driver is nil' if driver.nil?
 
       # Wrap single class into an array
       class_array = [class_array] unless class_array.instance_of? Array

data/lib/appium_lib/driver.rb

@@ -40,6 +40,26 @@ require 'uri'
 
 module Appium
   class Driver
+    # @private
+    class << self
+      def convert_to_symbol(value)
+        if value.nil?
+          value
+        else
+          value.to_sym
+        end
+      end
+
+      # @private
+      def get_cap(caps, name)
+        name_with_prefix = "#{::Appium::Core::Base::Bridge::APPIUM_PREFIX}#{name}"
+        caps[convert_to_symbol name] ||
+          caps[name] ||
+          caps[convert_to_symbol name_with_prefix] ||
+          caps[name_with_prefix]
+      end
+    end
+
     # attr readers are promoted to global scope. To avoid clobbering, they're
     # made available via the driver_attributes method
     #
@@ -156,7 +176,7 @@ module Appium
 
       $driver&.driver_quit if global_driver
 
-      raise 'opts must be a hash' unless opts.is_a? Hash
+      raise ArgumentError, 'opts must be a hash' unless opts.is_a? Hash
 
       @core = ::Appium::Core.for(opts)
       extend ::Appium::Core::Device
@@ -248,15 +268,11 @@ module Appium
       return unless @core.caps
 
       # return the path exists on the local
-      return if @core.caps['app'] && !@core.caps['app'].nil? && File.exist?(@core.caps['app'])
-      return if @core.caps[:app] && !@core.caps[:app].nil? && File.exist?(@core.caps[:app])
+      app_path = Driver.get_cap(@core.caps, 'app')
+      return if !app_path.nil? && File.exist?(app_path)
 
       # The app file is not exact path
-      if !@core.caps['app'].nil?
-        @core.caps['app'] = self.class.absolute_app_path opts
-      elsif !@core.caps[:app].nil?
-        @core.caps[:app] = self.class.absolute_app_path opts
-      end
+      @core.caps['app'] = self.class.absolute_app_path opts
     end
 
     # @private
@@ -329,7 +345,7 @@ module Appium
     #     action.click(element).perform # The `click` is a part of `PointerActions`
     #
     def action
-      @driver.action
+      @driver&.action
     end
 
     # Returns the server's version info
@@ -384,12 +400,11 @@ module Appium
     #
     # @return [String] APP_PATH as an absolute path
     def self.absolute_app_path(opts)
-      raise 'opts must be a hash' unless opts.is_a? Hash
+      raise ArgumentError, 'opts must be a hash' unless opts.is_a? Hash
 
-      # FIXME: 'caps' and 'app' will be correct
-      caps            = opts[:caps] || opts['caps'] || {}
-      app_path        = caps[:app] || caps['app']
-      raise 'absolute_app_path invoked and app is not set!' if app_path.nil? || app_path.empty?
+      caps = opts[:caps] || opts['caps'] || {}
+      app_path = get_cap(caps, 'app')
+      raise ArgumentError, 'absolute_app_path invoked and app is not set!' if app_path.nil? || app_path.empty?
       # Sauce storage API. http://saucelabs.com/docs/rest#storage
       return app_path if app_path.start_with? 'sauce-storage:'
       return app_path if app_path =~ URI::DEFAULT_PARSER.make_regexp # public URL for Sauce
@@ -431,7 +446,7 @@ module Appium
     # @param png_save_path [String] the full path to save the png
     # @return [File]
     def screenshot(png_save_path)
-      @driver.save_screenshot png_save_path
+      @driver&.save_screenshot png_save_path
     end
 
     # Takes a png screenshot of particular element's area
@@ -445,7 +460,7 @@ module Appium
     # @param [String] png_save_path the full path to save the png
     # @return [File]
     def element_screenshot(element, png_save_path)
-      @driver.take_element_screenshot element, png_save_path
+      @driver&.take_element_screenshot element, png_save_path
       nil
     end
 
@@ -469,6 +484,9 @@ module Appium
     #   size.height #=> Integer
     #
     def window_size
+      # maybe exception is expected as no driver created
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.window_size
     end
 
@@ -484,6 +502,8 @@ module Appium
     #   size.y #=> Integer
     #
     def window_rect
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.window_rect
     end
 
@@ -516,8 +536,11 @@ module Appium
     # @option http_client_ops [Hash] :open_timeout Custom open timeout for http client.
     # @option http_client_ops [Hash] :read_timeout Custom read timeout for http client.
     # @return [Selenium::WebDriver] the new global driver
-    def start_driver(http_client_ops =
-                         { http_client: ::Appium::Http::Default.new, open_timeout: 999_999, read_timeout: 999_999 })
+    def start_driver(http_client_ops = { http_client: nil, open_timeout: 999_999, read_timeout: 999_999 })
+      if http_client_ops[:http_client].nil?
+        http_client = ::Appium::Http::Default.new(open_timeout: http_client_ops[:open_timeout],
+                                                  read_timeout: http_client_ops[:read_timeout])
+      end
 
       # TODO: do not kill the previous session in the future version.
       if $driver.nil?
@@ -530,7 +553,12 @@ module Appium
       # starting driver.
       automation_name = @core.automation_name
 
-      @driver = @core.start_driver(server_url: server_url, http_client_ops: http_client_ops)
+      @driver = @core.start_driver(server_url: server_url,
+                                   http_client_ops: {
+                                     http_client: http_client,
+                                     open_timeout: 999_999,
+                                     read_timeout: 999_999
+                                   })
       @http_client = @core.http_client
 
       # if automation_name was nil before start_driver, then re-extend driver specific methods
@@ -555,7 +583,7 @@ module Appium
 
     # Set implicit wait to zero.
     def no_wait
-      @driver.manage.timeouts.implicit_wait = 0
+      @driver&.manage&.timeouts&.implicit_wait = 0
     end
 
     # Set implicit wait. Default to @default_wait.
@@ -570,7 +598,7 @@ module Appium
     # @return [void]
     def set_wait(timeout = nil)
       timeout = @default_wait if timeout.nil?
-      @driver.manage.timeouts.implicit_wait = timeout
+      @driver&.manage&.timeouts&.implicit_wait = timeout
     end
 
     # Returns existence of element.
@@ -589,9 +617,9 @@ module Appium
       # do not uset set_wait here.
       # it will cause problems with other methods reading the default_wait of 0
       # which then gets converted to a 1 second wait.
-      @driver.manage.timeouts.implicit_wait = pre_check
+      @driver&.manage&.timeouts&.implicit_wait = pre_check
       # the element exists unless an error is raised.
-      exists                                = true
+      exists = true
 
       begin
         yield # search for element
@@ -600,7 +628,7 @@ module Appium
       end
 
       # restore wait
-      @driver.manage.timeouts.implicit_wait = post_check if post_check != pre_check
+      @driver&.manage&.timeouts&.implicit_wait = post_check if post_check != pre_check
 
       exists
     end
@@ -610,6 +638,8 @@ module Appium
     # @param [*args] args The args to pass to the script
     # @return [Object]
     def execute_script(script, *args)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.execute_script script, *args
     end
 
@@ -618,6 +648,8 @@ module Appium
     ###
     # Get the window handles of open browser windows
     def execute_async_script(script, *args)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.execute_async_script script, *args
     end
 
@@ -650,41 +682,59 @@ module Appium
     #      r.logs   #=> The `logs` key part as `{'log' => [], 'warn' => [], 'error' => []}`
     #
     def execute_driver(script: '', type: 'webdriverio', timeout_ms: nil)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.execute_driver(script: script, type: type, timeout_ms: timeout_ms)
     end
 
     def window_handles
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.window_handles
     end
 
     # Get the current window handle
     def window_handle
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.window_handle
     end
 
     def navigate
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.navigate
     end
 
     def manage
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.manage
     end
 
     def get(url)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.get(url)
     end
 
     def current_url
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.current_url
     end
 
     def title
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.title
     end
 
     # @return [TargetLocator]
     # @see TargetLocator
     def switch_to
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.switch_to
     end
     ###
@@ -712,6 +762,8 @@ module Appium
     # @param [*args] args The args to use
     # @return [Array<Element>] Array is empty when no elements are found.
     def find_elements(*args)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.find_elements(*args)
     end
 
@@ -728,6 +780,8 @@ module Appium
     # @param [*args] args The args to use
     # @return [Element]
     def find_element(*args)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.find_element(*args)
     end
 
@@ -743,6 +797,8 @@ module Appium
     #     @driver.find_element_by_image './test/functional/data/test_element_image.png'
     #
     def find_element_by_image(png_img_path)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.find_element_by_image(png_img_path)
     end
 
@@ -758,6 +814,8 @@ module Appium
     #     @driver.find_elements_by_image ['./test/functional/data/test_element_image.png']
     #
     def find_elements_by_image(png_img_paths)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.find_elements_by_image(png_img_paths)
     end
 
@@ -771,6 +829,8 @@ module Appium
     # @option opts [Float] :altitude the altitude, defaulting to 75
     # @return [Selenium::WebDriver::Location] the location constructed by the selenium webdriver
     def set_location(opts = {})
+      raise NoDriverInstanceError if @driver.nil?
+
       latitude = opts.fetch(:latitude)
       longitude = opts.fetch(:longitude)
       altitude = opts.fetch(:altitude, 75)
@@ -794,10 +854,13 @@ module Appium
     #              #          'appium:anotherEvent' => 1572959315}
     #
     def log_event(vendor:, event:)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.logs.event vendor: vendor, event: event
     end
 
     def log_event=(log_event)
+      raise if @driver.nil?
       unless log_event.is_a?(Hash)
         raise ::Appium::Core::Error::ArgumentError('log_event should be Hash like { vendor: "appium", event: "funEvent"}')
       end
@@ -817,6 +880,8 @@ module Appium
     #   log_events #=> {'commands' => [{'cmd' => 123455, ....}], 'startTime' => 1572954894127, }
     #
     def log_events(type = nil)
+      raise NoDriverInstanceError if @driver.nil?
+
       @driver.logs.events(type)
     end
 

data/lib/appium_lib/error.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Appium
+  class Error < StandardError; end
+
+  # Driver instance hasn't been created yet.
+  class NoDriverInstanceError < Appium::Error; end
+
+  class ArgumentError < ArgumentError; end
+end

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

@@ -107,7 +107,7 @@ module Appium
     # @param index [Integer] the index
     # @return [Element]
     def ele_index(class_name, index)
-      raise 'Index must be >= 1' unless index == 'last()' || (index.is_a?(Integer) && index >= 1)
+      raise ArgumentError, 'Index must be >= 1' unless index == 'last()' || (index.is_a?(Integer) && index >= 1)
 
       elements = tags(class_name)
 
@@ -376,7 +376,7 @@ module Appium
     #
     def _all_pred(opts)
       predicate = opts[:predicate]
-      raise 'predicate must be provided' unless predicate
+      raise ArgumentError, 'predicate must be provided' unless predicate
 
       visible = opts.fetch :visible, true
       %($.mainApp().getAllWithPredicate("#{predicate}", #{visible});)
@@ -404,23 +404,23 @@ module Appium
     end
 
     def _validate_object(*objects)
-      raise 'objects must be an array' unless objects.is_a? Array
+      raise ArgumentError, 'objects must be an array' unless objects.is_a? Array
 
       objects.each do |obj|
         next unless obj # obj may be nil. if so, ignore.
 
         valid_keys   = %i[target substring insensitive]
         unknown_keys = obj.keys - valid_keys
-        raise "Unknown keys: #{unknown_keys}" unless unknown_keys.empty?
+        raise ArgumentError, "Unknown keys: #{unknown_keys}" unless unknown_keys.empty?
 
         target = obj[:target]
-        raise 'target must be a string' unless target.is_a? String
+        raise ArgumentError, 'target must be a string' unless target.is_a? String
 
         substring = obj[:substring]
-        raise 'substring must be a boolean' unless [true, false].include? substring
+        raise ArgumentError, 'substring must be a boolean' unless [true, false].include? substring
 
         insensitive = obj[:insensitive]
-        raise 'insensitive must be a boolean' unless [true, false].include? insensitive
+        raise ArgumentError, 'insensitive must be a boolean' unless [true, false].include? insensitive
       end
     end
 
@@ -456,16 +456,16 @@ module Appium
     def _by_json(opts)
       valid_keys = %i(typeArray onlyFirst onlyVisible name label value)
       unknown_keys = opts.keys - valid_keys
-      raise "Unknown keys: #{unknown_keys}" unless unknown_keys.empty?
+      raise ArgumentError, "Unknown keys: #{unknown_keys}" unless unknown_keys.empty?
 
       type_array = opts[:typeArray]
-      raise 'typeArray must be an array' unless type_array.is_a? Array
+      raise ArgumentError, 'typeArray must be an array' unless type_array.is_a? Array
 
       only_first = opts[:onlyFirst]
-      raise 'onlyFirst must be a boolean' unless [true, false].include? only_first
+      raise ArgumentError, 'onlyFirst must be a boolean' unless [true, false].include? only_first
 
       only_visible = opts[:onlyVisible]
-      raise 'onlyVisible must be a boolean' unless [true, false].include? only_visible
+      raise ArgumentError, 'onlyVisible must be a boolean' unless [true, false].include? only_visible
 
       # name/label/value are optional. when searching for class only, then none
       # will be present.

data/lib/appium_lib/ios/element/textfield.rb

@@ -42,7 +42,7 @@ module Appium
     def textfield(value)
       if value.is_a? Numeric
         index = value
-        raise "#{index} is not a valid index. Must be >= 1" if index <= 0
+        raise ArgumentError, "#{index} is not a valid index. Must be >= 1" if index <= 0
 
         index -= 1 # eles_by_json and _textfields_with_predicate is 0 indexed.
         result = eles_by_json(_textfield_visible)[index]

data/lib/appium_lib/ios/xcuitest/element/textfield.rb

@@ -37,7 +37,7 @@ module Appium
         def textfield(value)
           if value.is_a? Numeric
             index = value
-            raise "#{index} is not a valid index. Must be >= 1" if index <= 0
+            raise ArgumentError, "#{index} is not a valid index. Must be >= 1" if index <= 0
 
             index -= 1 # eles_by_json and _textfields_with_predicate is 0 indexed.
             result = _textfields_with_predicate[index]

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 = '15.1.0' unless defined? ::Appium::VERSION
-  DATE    = '2024-05-19' unless defined? ::Appium::DATE
+  VERSION = '15.2.1' unless defined? ::Appium::VERSION
+  DATE    = '2024-08-03' unless defined? ::Appium::DATE
 end

data/release_notes.md

@@ -1,3 +1,21 @@
+#### v15.2.1 2024-08-03
+
+- [693dc16](https://github.com/appium/ruby_lib/commit/693dc167cbbcbe1ab08d1142958207d635c480a3) Release 15.2.1
+- [d98126c](https://github.com/appium/ruby_lib/commit/d98126c47e04d7d152f85a2a75c3fdcb3011ae96) ci: add ci (#1037)
+- [fd2e639](https://github.com/appium/ruby_lib/commit/fd2e639b62e9b5c533915e7e860621391479c4aa) chore: modify rubocop.yml a bit
+- [0d1c2b8](https://github.com/appium/ruby_lib/commit/0d1c2b87b8f2ac456372bf4cbb2441fffae5cf27) chore: Update rubocop requirement from = 1.65.0 to = 1.65.1 (#1036)
+
+
+#### v15.2.0 2024-07-20
+
+- [d73525e](https://github.com/appium/ruby_lib/commit/d73525eec584c3c31690dcd55a6c52d641d43f9f) Release 15.2.0
+- [6b5d969](https://github.com/appium/ruby_lib/commit/6b5d9693f10e64a521f6ac5d31c78d71e5f0f6be) feat: raise its own defined errors (#1035)
+- [4a74c60](https://github.com/appium/ruby_lib/commit/4a74c60937e66bf028a66e4f05a324ce8b2077ce) chore: Update rubocop requirement from = 1.64.1 to = 1.65.0 (#1034)
+- [fa4cea4](https://github.com/appium/ruby_lib/commit/fa4cea4e5bea0aa4e3ed7052ba77812c82684fe0) chore: Update rubocop requirement from = 1.64.0 to = 1.64.1 (#1033)
+- [96ce262](https://github.com/appium/ruby_lib/commit/96ce26264d985b5260e99573486e8f712bfb12e3) chore: Update rubocop requirement from = 1.63.5 to = 1.64.0 (#1032)
+- [14590cc](https://github.com/appium/ruby_lib/commit/14590cce6f6cbef8c20e12ae10b00bf3f7b5ab3a) chore: tweak changelog format
+
+
 #### v15.1.0 2024-05-19
 
 - [b1534cc](https://github.com/appium/ruby_lib/commit/b1534cc8e781e37f9632fa1cbaa6e2422b6a768d) Release 15.1.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 15.1.0
+  version: 15.2.1
 platform: ruby
 authors:
 - code@bootstraponline.com
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-20 00:00:00.000000000 Z
+date: 2024-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appium_lib_core
@@ -17,14 +17,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '9.0'
+        version: '9.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 9.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '9.0'
+        version: '9.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 9.2.1
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -169,14 +175,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.63.5
+        version: 1.65.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.63.5
+        version: 1.65.1
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -203,6 +209,7 @@ files:
 - ".github/ISSUE_TEMPLATE.md"
 - ".github/PULL_REQUEST_TEMPLATE.md"
 - ".github/dependabot.yml"
+- ".github/workflows/functional-test.yml"
 - ".github/workflows/rubocop.yml"
 - ".gitignore"
 - ".rubocop.yml"
@@ -247,6 +254,7 @@ files:
 - lib/appium_lib/common/log.rb
 - lib/appium_lib/common/wait.rb
 - lib/appium_lib/driver.rb
+- lib/appium_lib/error.rb
 - lib/appium_lib/ios/common/errors.rb
 - lib/appium_lib/ios/common/helper.rb
 - lib/appium_lib/ios/element/alert.rb