appium_lib_core 5.8.0 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06c7b0bb078ece1a833874436e4611cb407cc762d73dd2fbcb27e69ace076e14
-  data.tar.gz: ab4e2733c06ed9866368e983c4e2a28510a4125eff5614e404c3e83f1eaceae9
+  metadata.gz: 0dba4d2485dc08929f8c9f6a8eeeb6fc6ba00c139b1b35e75889203a02e23078
+  data.tar.gz: 35da3fd8409a3a10c71a6b8f5ea59709e9ff4144e8e3a59aa8ddccbbe3bffded
 SHA512:
-  metadata.gz: fd894aaad52613559c842c0a42ff6d6bbfc9b871ea5f3bf02a302f7ae53e9b7cb6397bea363f9108ac9bbe601f1f1cacb5fa38ee4371eebaf875d2e64b756cf4
-  data.tar.gz: '097f706be4f0403e6397bdb941f1f63ced8c6cfae8a7f68af401ffcd0fa2e75d81051b37d1f421c9d60051c85f125c6662edb8461f8fcbc7afcaa6a89ba69142'
+  metadata.gz: b82f7a9c8868d97eddfee6fa85f1f2be3346ce268b23bbd264c02cad05e9f183ab46b40f717b9ae9e4ddfa15015e18108ec79e748f66996f33710fbb84933557
+  data.tar.gz: e02175948f0ff3a6b0e37e52e537c21262d9422e2027643d76f1b46eac55cd35b03f9fec1381ee3f3a9c4179b1888008bbbc5e9435df218d12c399efa76b8943

data/CHANGELOG.md

@@ -10,6 +10,15 @@ Read `release_notes.md` for commit level details.
 
 ### Deprecations
 
+## [6.1.0] - 2023-01-18
+
+### Bug fixes
+- `Element#immediate_value` sends `text` as the request body
+
+## [6.0.0] - 2022-12-25
+- Remove iOS/UiAutomation classes
+    - The version may work for iOS 8. XCUITest driver will be the default behavior for iOS.
+
 ## [5.8.0] - 2022-12-11
 
 ### Enhancements
@@ -24,7 +33,7 @@ Read `release_notes.md` for commit level details.
 ## [5.6.0] - 2022-11-08
 
 ### Enhancements
-- Append `selnium-webdriver` `4.6` support
+- Append `selenium-webdriver` `4.6` support
 
 ## [5.5.2] - 2022-10-11
 

data/README.md

@@ -32,6 +32,13 @@ $ bundle install
 $ bundle exec parallel_test test/unit/
 ```
 
+or
+
+```bash
+$ bundle install
+$ bundle exec rake test:unit
+```
+
 ### Functional Tests
 Run functional tests which require the Appium server and real device, Simulator/Emulator.
 
@@ -107,8 +114,8 @@ $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
         platformName: 'ios',
         platformVersion: '11.0',
         deviceName: 'iPhone Simulator',
-        automationName: 'XCUITest',
-        app: '/path/to/MyiOS.app'
+        # app: '/path/to/MyiOS.app',  # Without 'app' capability, an appium session starts with the home screen
+        automationName: 'XCUITest'
       },
       appium_lib: {
         wait: 30

data/appium_lib_core.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'appium_lib_core/version'
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = '>= 2.7'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.7')
 
   spec.name          = 'appium_lib_core'
   spec.version       = Appium::Core::VERSION
@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'minitest', '~> 5.0'
   spec.add_development_dependency 'minitest-reporters', '~> 1.1'
   spec.add_development_dependency 'webmock', '~> 3.18.1'
-  spec.add_development_dependency 'rubocop', '1.39.0'
+  spec.add_development_dependency 'rubocop', '1.42.0'
   spec.add_development_dependency 'appium_thor', '~> 1.0'
   spec.add_development_dependency 'parallel_tests'
   spec.add_development_dependency 'simplecov'

data/lib/appium_lib_core/common/base/bridge.rb

@@ -211,11 +211,6 @@ module Appium
           ::Appium::Core::Base::Capabilities.json_create execute(:get_capabilities)
         end
 
-        # Override for safe. Newer ruby selenium webdriver already has the same code
-        def page_source
-          execute :get_page_source
-        end
-
         # For Appium
         # override
         def element_displayed?(element)
@@ -229,7 +224,8 @@ module Appium
         # override
         def element_attribute(element, name)
           # For W3C in Selenium Client
-          # execute_atom :getAttribute, element, name
+          # execute_atom :getAttribute, element, name.
+          # 'dom_attribute' in the WebDriver Selenium.
           execute :get_element_attribute, id: element.id, name: name
         end
 

data/lib/appium_lib_core/common/base/search_context.rb

@@ -28,7 +28,6 @@ module Appium
           data_matcher:         '-android datamatcher', # Available in Espresso
           view_matcher:         '-android viewmatcher', # Available in Espresso
           # iOS
-          uiautomation:         '-ios uiautomation',
           predicate:            '-ios predicate string',
           class_chain:          '-ios class chain',
           # Windows with windows prefix

data/lib/appium_lib_core/common/command.rb

@@ -70,11 +70,15 @@ module Appium
         find_elements: [:post, 'session/:session_id/elements'],
         find_child_element: [:post, 'session/:session_id/element/:id/element'],
         find_child_elements: [:post, 'session/:session_id/element/:id/elements'],
+        find_shadow_child_element: [:post, 'session/:session_id/shadow/:id/element'],
+        find_shadow_child_elements: [:post, 'session/:session_id/shadow/:id/elements'],
         get_active_element: [:get, 'session/:session_id/element/active'],
         is_element_selected: [:get, 'session/:session_id/element/:id/selected'],
         get_element_attribute: [:get, 'session/:session_id/element/:id/attribute/:name'],
         get_element_property: [:get, 'session/:session_id/element/:id/property/:name'],
         get_element_css_value: [:get, 'session/:session_id/element/:id/css/:property_name'],
+        get_element_aria_role: [:get, 'session/:session_id/element/:id/computedrole'],
+        get_element_aria_label: [:get, 'session/:session_id/element/:id/computedlabel'],
         get_element_text: [:get, 'session/:session_id/element/:id/text'],
         get_element_tag_name: [:get, 'session/:session_id/element/:id/name'],
         get_element_rect: [:get, 'session/:session_id/element/:id/rect'],

data/lib/appium_lib_core/common/device/value.rb

@@ -41,9 +41,7 @@ module Appium
             # Keep .split(//) for backward compatibility for now
             text = keys.join
 
-            # FIXME: further work for W3C. Over appium 1.15.0 or later
-            # { value: text.split(//), text: text }
-            { value: text.chars }
+            { text: text }
           end
         end # module Value
       end # module Device

data/lib/appium_lib_core/driver.rb

@@ -23,7 +23,6 @@ module Appium
     end
 
     module Ios
-      autoload :Uiautomation, 'appium_lib_core/ios'
       autoload :Xcuitest, 'appium_lib_core/ios_xcuitest'
     end
 
@@ -328,7 +327,7 @@ module Appium
       public
 
       # @private
-      # Set up for a neww session
+      # Set up for a new session
       def setup_for_new_session(opts = {})
         @custom_url = opts.delete :url # to set the custom url as :url
 
@@ -443,7 +442,7 @@ module Appium
         @driver
       end
 
-      # @privvate
+      # @private
       # Attach to an existing session
       def attach_to(session_id, url: nil, automation_name: nil, platform_name: nil,
                     http_client_ops: { http_client: nil, open_timeout: 999_999, read_timeout: 999_999 })
@@ -509,7 +508,7 @@ module Appium
         {}
       end
 
-      # Quits the driver
+      # [Deprecated] Quits the driver. This method is the same as @driver.quit
       # @return [void]
       #
       # @example
@@ -517,6 +516,7 @@ module Appium
       #   @core.quit_driver
       #
       def quit_driver
+        ::Appium::Logger.warn('[DEPRECATION] quit_driver will be removed. Please use @driver.quit instead.')
         @driver.quit
       rescue # rubocop:disable Style/RescueStandardError
         nil
@@ -562,6 +562,11 @@ module Appium
       #     @core.platform_version #=> [10,1,1]
       #
       def platform_version
+        ::Appium::Logger.warn(
+          '[DEPRECATION] platform_version method will be. ' \
+          'Please check the platformVersion via @driver.capabilities["platformVersion"] instead.'
+        )
+
         p_version = @driver.capabilities['platformVersion'] || @driver.session_capabilities['platformVersion']
         p_version.split('.').map(&:to_i)
       end
@@ -599,10 +604,8 @@ module Appium
           case sym_automation_name
           when :safari
             ::Appium::Logger.debug('SafariDriver for iOS')
-          when :xcuitest
+          else # XCUITest
             ::Appium::Core::Ios::Xcuitest::Bridge.for self
-          else # default and UIAutomation
-            ::Appium::Core::Ios::Uiautomation::Bridge.for self
           end
         when :mac
           case sym_automation_name

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '5.8.0' unless defined? ::Appium::Core::VERSION
-    DATE    = '2022-12-11' unless defined? ::Appium::Core::DATE
+    VERSION = '6.1.0' unless defined? ::Appium::Core::VERSION
+    DATE    = '2023-01-18' unless defined? ::Appium::Core::DATE
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 5.8.0
+  version: 6.1.0
 platform: ruby
 authors:
 - Kazuaki MATSUO
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-12-11 00:00:00.000000000 Z
+date: 2023-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -120,14 +120,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.39.0
+        version: 1.42.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.39.0
+        version: 1.42.0
 - !ruby/object:Gem::Dependency
   name: appium_thor
   requirement: !ruby/object:Gem::Requirement
@@ -247,12 +247,8 @@ files:
 - lib/appium_lib_core/device.rb
 - lib/appium_lib_core/driver.rb
 - lib/appium_lib_core/element.rb
-- lib/appium_lib_core/ios.rb
 - lib/appium_lib_core/ios/device.rb
 - lib/appium_lib_core/ios/device/clipboard.rb
-- lib/appium_lib_core/ios/uiautomation/bridge.rb
-- lib/appium_lib_core/ios/uiautomation/device.rb
-- lib/appium_lib_core/ios/uiautomation/patch.rb
 - lib/appium_lib_core/ios/xcuitest/bridge.rb
 - lib/appium_lib_core/ios/xcuitest/device.rb
 - lib/appium_lib_core/ios/xcuitest/device/battery.rb
@@ -273,7 +269,7 @@ homepage: https://github.com/appium/ruby_lib_core/
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -288,8 +284,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
-signing_key:
+rubygems_version: 3.2.14
+signing_key: 
 specification_version: 4
 summary: Minimal Ruby library for Appium.
 test_files: []

data/lib/appium_lib_core/ios/uiautomation/bridge.rb

@@ -1,30 +0,0 @@
-# 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
-  module Core
-    module Ios
-      module Uiautomation
-        module Bridge
-          def self.for(target)
-            target.extend Appium::Core::Ios::Device
-
-            Core::Ios::Uiautomation.patch_webdriver_element
-            Core::Ios::Uiautomation::Device.add_methods
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib_core/ios/uiautomation/device.rb

@@ -1,44 +0,0 @@
-# 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
-  module Core
-    module Ios
-      module Uiautomation
-        module Device
-          def self.add_methods
-            # UiAutomation, Override included method in bridge
-            ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
-              def hide_keyboard(close_key = nil, strategy = nil)
-                option = {}
-
-                option[:key] = close_key || 'Done'        # default to Done key.
-                option[:strategy] = strategy || :pressKey # default to pressKey
-
-                execute :hide_keyboard, {}, option
-              end
-            end
-
-            # UiAutomation, Override included method in bridge
-            ::Appium::Core::Device.add_endpoint_method(:background_app) do
-              def background_app(duration = 0)
-                execute :background_app, {}, seconds: duration
-              end
-            end
-          end
-        end # module Device
-      end # module Uiautomation
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/ios/uiautomation/patch.rb

@@ -1,34 +0,0 @@
-# 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
-  module Core
-    module Ios
-      module Uiautomation
-        # @private
-        # class_eval inside a method because class Selenium::WebDriver::Element
-        # will trigger as soon as the file is required. in contrast a method
-        # will trigger only when invoked.
-        def self.patch_webdriver_element
-          ::Appium::Core::Element.class_eval do
-            # Cross platform way of entering text into a textfield
-            def type(text, driver)
-              driver.execute_script %(au.getElement('#{ref}').setValue('#{text}');)
-            end # def type
-          end # Selenium::WebDriver::Element.class_eval
-        end # def patch_webdriver_element
-      end # module Uiautomation
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/ios.rb

@@ -1,20 +0,0 @@
-# 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.
-
-# loaded in common/driver.rb
-require_relative 'ios/device'
-
-require_relative 'ios/uiautomation/patch'
-require_relative 'ios/uiautomation/device'
-require_relative 'ios/uiautomation/bridge'