appium_lib 14.0.0 → 15.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d65ea4366c372a5373958ea7125c3e29d77ef6a81f8b2a253f35af502862fe45
-  data.tar.gz: cd78b843b6fc93c5543f432f8692e6d8fef8811f1b702cef315107fb5fd55c69
+  metadata.gz: 796adeac9cf88dc053e753f5247424776c3fc76e7315faab0707a701b51626d1
+  data.tar.gz: 324af242f927a23024b497aa8ecbedd68dc83553473b2901e3a6dfc2da01849a
 SHA512:
-  metadata.gz: 5dc042d28bee04bb6b1dc456cdfe64b462c3026ddde762e60fffa540c0c5ad01abb274dd41d0dc250f446d0bc3fcc0b3f59432afb95173cf25841e75ee54bebf
-  data.tar.gz: 6e077d34a67bd6eb7a5a456113f35c78734d4f7bc4d3a5ff7f91d288f0bf93d1bb55b1420f44240e2b6c478ba509843d6067f40b447bde468de78388565d66e1
+  metadata.gz: '065363852318ced51ba308b9bc4b9708b66650d746e840f672721e58ae8a32351fd4be26df57f78794ba23f5de98ed22af77fceafeccf38cb80b3efc7545ab2e'
+  data.tar.gz: c03a4fd8b6966e60fd65fc33202a07a6fd4220f57eac3220acc82e8d33ec3562ccfa520ffc18996ac7758ba5019939320393733ad48c543371816788f67c36c2

data/.github/workflows/rubocop.yml

@@ -11,7 +11,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: [3.0, 3.1, 3.2]
+        ruby: [3.0, 3.1, 3.2, 3.3]
 
     runs-on: ubuntu-latest
 
@@ -23,5 +23,7 @@ jobs:
         ruby-version: ${{ matrix.ruby }}
     - name: Install dependencies
       run: bundle install
-    - name: Run tests
+    - name: Run rubocop
       run: bundle exec rake rubocop
+    - name: Run tests
+      run: bundle exec rake test

data/CHANGELOG.md

@@ -4,10 +4,24 @@ Commit based release not is [release_notes.md](./release_notes.md)
 Release tags are https://github.com/appium/ruby_lib/releases .
 
 
+## [15.1.0] - 2024-05-19
+- Use appium_lib_core 9.0.0
+
+## 15.0.1 - 2024-04-26
+- Bump release module (internal only)
+
+## 15.0.0 - 2024-04-11
+- Breaking
+    - Use appium_lib_core 8.0.0 and up
+        - Please refer to [the diff](https://github.com/appium/ruby_lib_core/blob/master/CHANGELOG.md#800---2024-03-08) about the details.
+        - Remove `Appium::MultiTouch` and `Appium::TouchAction`
+            - `swipe` could use `mobile:swipe`, or w3c actions. Multi-touch actions such as zoom/pinch can be written in w3c actions.
+            - Please use [w3c actions](https://github.com/appium/ruby_lib/blob/master/docs/w3c.md) instead. Several resources such as [test code in ruby_lib_core](https://github.com/appium/ruby_lib_core/blob/master/test/functional/common_w3c_actions.rb) also would help to check the syntax.
+
 ## 14.0.0 - 2024-01-25
 - Use appium_lib_core  7.4.0 and up
     - Removed deprecated `export_session` and `export_session_path`
-    - Please get the session id via `driver.session_id` intead
+    - Please get the session id via `driver.session_id` instead
 
 ## 13.0.2 - 2024-01-25
 - Allow up to appium_lib_core 7.3

data/Rakefile

@@ -14,6 +14,7 @@
 
 require 'bundler/gem_tasks'
 require 'rubocop/rake_task'
+require 'rake/testtask'
 
 desc 'Execute RuboCop static code analysis'
 RuboCop::RakeTask.new(:rubocop) do |t|
@@ -21,3 +22,10 @@ RuboCop::RakeTask.new(:rubocop) do |t|
   t.options = %w(-D)
   t.fail_on_error = true
 end
+
+desc('Run all unit tests in test directory')
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList[ENV['TESTS'] ? ENV['TESTS'].split(',') : 'test/**/*_test.rb']
+end

data/Thorfile

@@ -4,12 +4,4 @@ Appium::Thor::Config.set do
   gem_name     'appium_lib'
   github_name  'ruby_lib'
   version_file 'lib/appium_lib/version.rb'
-  docs_block do
-    common_globs  = %w(/lib/appium_lib/*.rb /lib/appium_lib/device/*.rb /lib/appium_lib/common/**/*.rb)
-    android_globs = common_globs + %w(/lib/appium_lib/android/**/*.rb)
-    ios_globs     = common_globs + %w(/lib/appium_lib/ios/**/*.rb)
-
-    run 'docs/android_docs.md', globs(android_globs)
-    run 'docs/ios_docs.md', globs(ios_globs)
-  end
 end

data/appium_lib.gemspec

@@ -5,7 +5,6 @@ Gem::Specification.new do |s|
 
   s.name          = 'appium_lib'
   s.version       = Appium::VERSION
-  s.date          = Appium::DATE
   s.license       = 'Apache-2.0'
   s.description   = 'Ruby library for Appium.'
   s.summary       = 'Ruby library for Appium'
@@ -14,19 +13,20 @@ 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', '>= 7.4.0', '< 8'
+  s.add_runtime_dependency 'appium_lib_core', '~> 9.0'
   s.add_runtime_dependency 'nokogiri', '~> 1.8', '>= 1.8.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 'appium_thor', '~> 2.0'
   s.add_development_dependency 'fakefs', '~> 2.5.0'
   s.add_development_dependency 'hashdiff', '~> 1.1.0'
-  s.add_development_dependency 'posix-spawn', '~> 0.3'
+  s.add_development_dependency 'minitest', '~> 5.0'
+  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.60.1'
-  s.add_development_dependency 'spec', '~> 5.3', '>= 5.3.4'
+  s.add_development_dependency 'rubocop', '1.63.5'
   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)\/.+/) }
+  s.metadata['rubygems_mfa_required'] = 'true'
 end

data/docs/w3c.md

@@ -11,11 +11,15 @@ dialect #=> :w3c
 el = find_element(:name, 'Pickers')
 driver.action.click(el).perform #=> work
 
+
+# Scroll/Swipe
 driver.action
       .move_to_location(500, 500).pointer_down(:left)
       .move_to_location(0, 700)
       .release.perform
 
+
+# Zoom in
 # multiple action chains
 f1 = driver.action.add_pointer_input(:touch, 'finger1')
 f1.create_pointer_move(duration: 1, x: 200, y: 500,
@@ -48,4 +52,4 @@ driver.perform_actions [f1, f2]
 ## Limitations
 - WebDriverAgent support only `touch` as a `pointer type`.
     - By default, [ruby_lib_core](https://github.com/appium/ruby_lib_core/blob/ab5d7c5ed31f318a9395e5aeafe1d0d655d3cff4/lib/appium_lib_core/common/base/w3c_bridge.rb#L26) generate `touch` based actions.
-    - About `pointer type` => [W3C](https://www.w3.org/TR/webdriver/#perform-actions) and [Simple WD Spec](https://github.com/jlipps/simple-wd-spec#perform-actions) 
+    - About `pointer type` => [W3C](https://www.w3.org/TR/webdriver/#perform-actions) and [Simple WD Spec](https://github.com/jlipps/simple-wd-spec#perform-actions)

data/lib/appium_lib/appium.rb

@@ -26,8 +26,6 @@ require_relative 'sauce_labs'
 require_relative 'common/wait'
 require_relative 'common/log'
 require_relative 'common/helper'
-require_relative 'common/multi_touch'
-require_relative 'common/touch_actions'
 require_relative 'common/http_client'
 require_relative 'common/device'
 require_relative 'common/command'

data/lib/appium_lib/common/device.rb

@@ -15,29 +15,5 @@
 module Appium
   module Device
     extend Forwardable
-
-    class << self
-      def extended(_mod)
-        add_touch_actions
-      end
-
-      private
-
-      def add_touch_actions
-        actions = Appium::TouchAction::COMPLEX_ACTIONS
-        actions.each do |method|
-          delegate_from_appium_driver(method, Appium::TouchAction)
-        end
-
-        # To keep compatibility
-        # pinch and zoom are defined in Appium::MultiTouch.
-        delegate_from_appium_driver(:pinch, Appium::MultiTouch)
-        delegate_from_appium_driver(:zoom, Appium::MultiTouch)
-      end
-
-      def delegate_from_appium_driver(method, delegation_target)
-        def_delegator delegation_target, method
-      end
-    end # class << self
   end # module Device
 end # module Appium

data/lib/appium_lib/driver.rb

@@ -321,7 +321,7 @@ module Appium
     # 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]
+    # @return [Selenium::WebDriver::PointerActions]
     #
     # @example
     #
@@ -358,7 +358,7 @@ module Appium
     def platform_version
       return [] if @driver.nil?
 
-      p_version = @driver.capabilities['platformVersion'] || @driver.session_capabilities['platformVersion']
+      p_version = @driver.capabilities['platformVersion']
       p_version.split('.').map(&:to_i)
     end
 
@@ -779,8 +779,7 @@ module Appium
 
     # @since Appium 1.16.0
     #
-    # Logs a custom event. The event is available via {::Appium::Core::Events#get} or
-    # <code>driver.session_capabilities['events']</code> with <code>eventTimings</code> capabilities.
+    # Logs a custom event. The event is available via {::Appium::Core::Events#get}.
     #
     # @param [String] vendor The vendor prefix for the event
     # @param [String] event The name of event

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 = '14.0.0' unless defined? ::Appium::VERSION
-  DATE    = '2024-01-25' unless defined? ::Appium::DATE
+  VERSION = '15.1.0' unless defined? ::Appium::VERSION
+  DATE    = '2024-05-19' unless defined? ::Appium::DATE
 end

data/release_notes.md

@@ -1,3 +1,37 @@
+#### v15.1.0 2024-05-19
+
+- [b1534cc](https://github.com/appium/ruby_lib/commit/b1534cc8e781e37f9632fa1cbaa6e2422b6a768d) Release 15.1.0
+- [f6cc482](https://github.com/appium/ruby_lib/commit/f6cc482e6bcf75cd4388911355700e31da74b578) chore: tweak deps
+- [c034ec5](https://github.com/appium/ruby_lib/commit/c034ec5cb74e442db6db4cfc8365a43c903cbbfc) feat: update ruby lib core to v9 (#1030)
+- [50bca8f](https://github.com/appium/ruby_lib/commit/50bca8f8acd2c4c144684cd33dd0ea9787a40bf5) chore: Update rubocop requirement from = 1.63.4 to = 1.63.5 (#1028)
+- [415b3c6](https://github.com/appium/ruby_lib/commit/415b3c6b52e28f3b43cdd95a0684b1e9aadc0ae8) chore: Update rubocop requirement from = 1.63.3 to = 1.63.4 (#1027)
+- [7461e6a](https://github.com/appium/ruby_lib/commit/7461e6a44569245b6dbd1b352f3ff76503bb1bbb) docs: remove no longer used docs
+- [66e323c](https://github.com/appium/ruby_lib/commit/66e323c08dbc9616366e55ebf3835530549edf37) chore: remove unused docs_block
+
+
+#### v15.0.1 2024-04-26
+
+- [3ab38a7](https://github.com/appium/ruby_lib/commit/3ab38a7339bf077dd85d9b700f08ddfe2ca608e5) Release 15.0.1
+- [720dfdd](https://github.com/appium/ruby_lib/commit/720dfdd31f0feacf5926f668ff15e521920e360c) chore: bump thor and remove unused posix
+- [c869327](https://github.com/appium/ruby_lib/commit/c869327d50d2046a2c45e3a360b8667e006f9f56) chore: Update rubocop requirement from = 1.63.2 to = 1.63.3 (#1026)
+- [6543765](https://github.com/appium/ruby_lib/commit/65437658a89b234fbc431246266a383a0988009a) chore: Update rubocop requirement from = 1.63.1 to = 1.63.2 (#1025)
+- [2b428b5](https://github.com/appium/ruby_lib/commit/2b428b5e714e83ee283bce993fd3eba61827a287) chore: Update rubocop requirement from = 1.63.0 to = 1.63.1 (#1024)
+
+
+#### v15.0.0 2024-04-11
+
+- [203a605](https://github.com/appium/ruby_lib/commit/203a6052db42039c89cd000f245f1534379bc86b) Release 15.0.0
+- [7ab9f44](https://github.com/appium/ruby_lib/commit/7ab9f442ee9a9d22ad021316171e6824628eeb99) chore: Update rubocop requirement from = 1.62.1 to = 1.63.0 (#1023)
+- [ad20d82](https://github.com/appium/ruby_lib/commit/ad20d828e8124f37c3ab3055c744c2c76c74f563) ci: add 3.3
+- [df9752c](https://github.com/appium/ruby_lib/commit/df9752c5176db395e7a427a77c4755293ff75cee) feat: remove "spec" deps (#1022)
+- [c5a7216](https://github.com/appium/ruby_lib/commit/c5a7216c005bb819ff7bc3fe313e7400777b9587) test: add empty test code (#1021)
+- [c450c20](https://github.com/appium/ruby_lib/commit/c450c20bae801e2f9f9ce66a9df2e352a614f73f) feat: bump ruby lib core v8 (#1018)
+- [9d40e0e](https://github.com/appium/ruby_lib/commit/9d40e0e2c2cbe571fd788c12565b3cb3d92f16a4) chore: Update rubocop requirement from = 1.62.0 to = 1.62.1 (#1020)
+- [98861af](https://github.com/appium/ruby_lib/commit/98861af3d779ce288937344a63aec7cbefed9db1) chore: Update rubocop requirement from = 1.61.0 to = 1.62.0 (#1017)
+- [1b385bc](https://github.com/appium/ruby_lib/commit/1b385bc2bab3f45d38a4f58e8c79ddbbe58d5596) chore: Update rubocop requirement from = 1.60.2 to = 1.61.0 (#1016)
+- [612d944](https://github.com/appium/ruby_lib/commit/612d944fc60b202d3e24c7e052004cef1b69c8d0) chore: Update rubocop requirement from = 1.60.1 to = 1.60.2 (#1013)
+
+
 #### v14.0.0 2024-01-25
 
 - [50cf980](https://github.com/appium/ruby_lib/commit/50cf980b570acd7d2d95ea64d1d1b0225f96c73b) Release 14.0.0

data/test/first_test.rb

@@ -0,0 +1,29 @@
+# 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.
+
+require 'minitest/autorun'
+require 'minitest/reporters'
+require 'minitest'
+
+begin
+  Minitest::Reporters.use! [Minitest::Reporters::ProgressReporter.new]
+rescue Errno::ENOENT
+  # Ignore since Minitest::Reporters::JUnitReporter.new fails in deleting files, sometimes
+end
+
+class SampleTest < Minitest::Test
+  def test_test
+    assert(true)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 14.0.0
+  version: 15.1.0
 platform: ruby
 authors:
 - code@bootstraponline.com
@@ -9,28 +9,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-25 00:00:00.000000000 Z
+date: 2024-05-20 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: 7.4.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 7.4.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '9.0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -77,20 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.4
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.4
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: fakefs
   requirement: !ruby/object:Gem::Requirement
@@ -120,19 +108,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.1.0
 - !ruby/object:Gem::Dependency
-  name: posix-spawn
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -167,34 +169,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.60.1
+        version: 1.63.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.60.1
-- !ruby/object:Gem::Dependency
-  name: spec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.3'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.3.4
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.3'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.3.4
+        version: 1.63.5
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -231,10 +213,8 @@ files:
 - Thorfile
 - appium_lib.gemspec
 - contributing.md
-- docs/android_docs.md
 - docs/android_uiautomator.md
 - docs/docs.md
-- docs/ios_docs.md
 - docs/ios_xcuitest.md
 - docs/parallel.md
 - docs/w3c.md
@@ -265,8 +245,6 @@ files:
 - lib/appium_lib/common/helper.rb
 - lib/appium_lib/common/http_client.rb
 - lib/appium_lib/common/log.rb
-- lib/appium_lib/common/multi_touch.rb
-- lib/appium_lib/common/touch_actions.rb
 - lib/appium_lib/common/wait.rb
 - lib/appium_lib/driver.rb
 - lib/appium_lib/ios/common/errors.rb
@@ -296,10 +274,12 @@ files:
 - lib/appium_lib/version.rb
 - readme.md
 - release_notes.md
+- test/first_test.rb
 homepage: https://github.com/appium/ruby_lib
 licenses:
 - Apache-2.0
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -315,7 +295,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.9
 signing_key:
 specification_version: 4
 summary: Ruby library for Appium