appium_lib_core 6.2.0 → 6.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2797136f9ad9290a9e38fe27dd02d99c99ae12656e378a049dd653190be569bc
-  data.tar.gz: 38c66b8f7fd0fdab194906cdf05640301431fab6a0b91492125a6c8f9f3d4993
+  metadata.gz: c45a558b448d89b1b356b221257279ff8c148680a1dc09f7414877e6e59a6257
+  data.tar.gz: d09d57109c80759c9b92942b7f8e1424c2614f34e4fcdbe9f6d4d0e48ee41816
 SHA512:
-  metadata.gz: f6168e1739ede67cbdb0eae874498d6a156d93c8fce9684b37108b40d183395ce5089659f70af8724adae804caeaafd490a318a22d2527bae98b597a40befa1a
-  data.tar.gz: c7126ebb44078aaacae3c81ebf39853d1c9da0b6718ed74f28209ed13f8b639f85a6b36744e311105fca5a340b103da21bd1ca3b72d3545d818c3bb5891ac5d9
+  metadata.gz: 6f50481e6656b18e7dfe5dc631137ab1ab041c9c6087fcf27b1fd24e91814e83ce051f22db1a3e4b41f5d2a4b8320e2ac7c323638e9e9b76d2508d66a7992cdf
+  data.tar.gz: 0b04644ee8c7704080935777b01886cca17acce8dab8c7953b769c9dd9ca33efc588e3da5e08bba6a91f0ac17bde973c607f3b886c4724eb84be3c44aece2690

data/CHANGELOG.md

@@ -10,7 +10,20 @@ Read `release_notes.md` for commit level details.
 
 ### Deprecations
 
-## [6.2.0]
+## [6.3.0] - 2023-03-14
+
+### Enhancements
+- Support custom listener
+    - e.g. A listener named `CustomListener` which inherits `::Selenium::WebDriver::Support::AbstractEventListener` can set as `appium_lib: { listener: CustomListener.new}` capability
+
+## [6.2.1] - 2023-03-09
+
+### Enhancements
+- Add `uia_device_orientation_landscaperight` and `uia_device_orientation_portrait_upsidedown` symbols in the `drivede.rotation=`
+- Add `drivede.orientation=` as a syntax sugar of `drivede.rotation=`
+
+
+## [6.2.0] - 2023-01-26
 
 ### Enhancements
 

data/README.md

@@ -154,6 +154,29 @@ attached_driver.page_source
 Read [Appium/Core/Driver](https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Driver) to catch up with available capabilities.
 Capabilities affect only ruby_lib is [Appium/Core/Options](https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Options).
 
+
+### Gives custom listener
+
+An example to define a customer listener with [Selenium::WebDriver::Support::AbstractEventListener](https://www.selenium.dev/selenium/docs/api/rb/Selenium/WebDriver/Support/AbstractEventListener.html)
+
+```ruby
+class CustomListener < ::Selenium::WebDriver::Support::AbstractEventListener
+  // something
+end
+capabilities: {
+  platformName: :ios,
+  platformVersion: '11.0',
+  deviceName: 'iPhone Simulator',
+  automationName: 'XCUITest',
+  app: '/path/to/MyiOS.app'
+},
+appium_lib: {
+  listener: CustomListener.new
+}
+@core = Appium::Core.for capabilities: capabilities, appium_lib: appium_lib
+@core.start_driver
+```
+
 # Development
 - Demo app
     - https://android.googlesource.com/platform/development/+/master/samples/ApiDemos

data/appium_lib_core.gemspec

@@ -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.44.0'
+  spec.add_development_dependency 'rubocop', '1.47.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/driver.rb

@@ -44,16 +44,25 @@ module Appium
         # Do not use this for general use. Used by flutter driver to get bridge for creating a new element
         attr_reader :bridge
 
-        private
-
         def initialize(bridge: nil, listener: nil, **opts)
+          original_opts = opts.dup
+
           # For ::Appium::Core::Waitable
           @wait_timeout = opts.delete(:wait_timeout)
           @wait_interval = opts.delete(:wait_interval)
 
-          super
+          # Selenium WebDriver attributes
+          @devtools = nil
+          @bidi = nil
+
+          # in the selenium webdriver as well
+          bridge ||= create_bridge(**opts)
+          add_extensions(bridge.browser)
+          @bridge = listener ? ::Appium::Support::EventFiringBridge.new(bridge, listener, **original_opts) : bridge
         end
 
+        private
+
         # Create a proper bridge instance.
         #
         # @return [::Appium::Core::Base::Bridge]
@@ -947,8 +956,6 @@ module Appium
         #   #           "appPackage"=>"io.appium.android.apis",
         #   #           "appActivity"=>"io.appium.android.apis.ApiDemos",
         #   #           "someCapability"=>"some_capability",
-        #   #           "unicodeKeyboard"=>true,
-        #   #           "resetKeyboard"=>true},
         #   #      "automationName"=>"uiautomator2",
         #   #      "app"=>"/path/to/app/api.apk.zip",
         #   #      "platformVersion"=>"8.1.0",
@@ -956,8 +963,6 @@ module Appium
         #   #      "appPackage"=>"io.appium.android.apis",
         #   #      "appActivity"=>"io.appium.android.apis.ApiDemos",
         #   #      "someCapability"=>"some_capability",
-        #   #      "unicodeKeyboard"=>true,
-        #   #      "resetKeyboard"=>true,
         #   #      "deviceUDID"=>"emulator-5554",
         #   #      "deviceScreenSize"=>"1080x1920",
         #   #      "deviceScreenDensity"=>420,
@@ -1073,7 +1078,7 @@ module Appium
         #
         # @param [String] img_path A path to a partial image you'd like to find
         #
-        # @return [Array<Selenium::WebDriver::Element>]
+        # @return [Array<::Appium::Core::Element>]
         #
         # @example
         #

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

@@ -37,7 +37,7 @@ module Appium
           attr_reader :additional_headers
 
           # override
-          def initialize(open_timeout: nil, read_timeout: nil) # rubocop:disable Lint/MissingSuper
+          def initialize(open_timeout: nil, read_timeout: nil)
             @open_timeout = open_timeout
             @read_timeout = read_timeout
             @additional_headers = {}

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

@@ -20,12 +20,18 @@ module Appium
       #
 
       module Rotatable
-        ORIENTATIONS = %i[landscape portrait].freeze
+        ORIENTATIONS = %i[
+          landscape
+          portrait
+          uia_device_orientation_landscaperight
+          uia_device_orientation_portrait_upsidedown
+        ].freeze
 
         #
         # Change the screen orientation
         #
-        # @param [:landscape, :portrait] orientation
+        # @param [:landscape, :portrait,
+        #         :uia_device_orientation_landscaperight, :uia_device_orientation_portrait_upsidedown] orientation
         #
         #
         def rotation=(orientation)
@@ -36,11 +42,13 @@ module Appium
           bridge.screen_orientation = orientation.to_s.upcase
         end
         alias rotate rotation=
+        alias orientation= rotation=
 
         #
         # Get the current screen orientation
         #
-        # @return [:landscape, :portrait] orientation
+        # @return [:landscape, :portrait,
+        #          :uia_device_orientation_landscaperight, :uia_device_orientation_portrait_upsidedown] orientation
         #
         # @api public
         #

data/lib/appium_lib_core/driver.rb

@@ -276,6 +276,23 @@ module Appium
       #     @core = Appium::Core.for(opts) # create a core driver with 'opts' and extend methods into 'self'
       #     @core.start_driver # start driver with 'url'. Connect to 'http://custom-host:8080/wd/hub.com'
       #
+      #     # With a custom listener
+      #     class CustomListener < ::Selenium::WebDriver::Support::AbstractEventListener
+      #       // something
+      #     end
+      #     capabilities: {
+      #       platformName: :ios,
+      #       platformVersion: '11.0',
+      #       deviceName: 'iPhone Simulator',
+      #       automationName: 'XCUITest',
+      #       app: '/path/to/MyiOS.app'
+      #     },
+      #     appium_lib: {
+      #       listener: CustomListener.new,
+      #     }
+      #     @core = Appium::Core.for capabilities: capabilities, appium_lib: appium_lib
+      #     @core.start_driver
+      #
       def self.for(opts = {})
         new.setup_for_new_session(opts)
       end

data/lib/appium_lib_core/support/event_firing_bridge.rb

@@ -0,0 +1,57 @@
+# 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 Support
+    class EventFiringBridge < ::Selenium::WebDriver::Support::EventFiringBridge
+      # This module inherits ::Selenium::WebDriver::Support::EventFiringBridge
+      # to provide customer listener availability.
+      # https://github.com/SeleniumHQ/selenium/blob/trunk/rb/lib/selenium/webdriver/support/event_firing_bridge.rb#L79
+
+      def initialize(delegate, listener, **opts)
+        @appium_options = opts
+        super delegate, listener
+      end
+
+      def find_element_by(how, what, parent = nil)
+        e = dispatch(:find, how, what, driver) do
+          @delegate.find_element_by how, what, parent
+        end
+
+        ::Appium::Core::Element.new self, e.ref.last
+      end
+
+      def find_elements_by(how, what, parent = nil)
+        es = dispatch(:find, how, what, driver) do
+          @delegate.find_elements_by(how, what, parent)
+        end
+
+        es.map { |e| ::Appium::Core::Element.new self, e.ref.last }
+      end
+
+      private
+
+      def create_element(ref)
+        ::Appium::Core::Element.new @delegate, ref
+      end
+
+      def driver
+        # To not gives the listener
+        @appium_options.delete(:listener)
+
+        @driver ||= ::Appium::Core::Base::Driver.new(bridge: self, listener: nil, **@appium_options)
+      end
+    end
+  end
+end

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '6.2.0' unless defined? ::Appium::Core::VERSION
-    DATE    = '2023-01-26' unless defined? ::Appium::Core::DATE
+    VERSION = '6.3.0' unless defined? ::Appium::Core::VERSION
+    DATE    = '2023-03-14' unless defined? ::Appium::Core::DATE
   end
 end

data/lib/appium_lib_core.rb

@@ -19,6 +19,7 @@ require_relative 'appium_lib_core/common'
 require_relative 'appium_lib_core/driver'
 require_relative 'appium_lib_core/device'
 require_relative 'appium_lib_core/element'
+require_relative 'appium_lib_core/support/event_firing_bridge'
 
 module Appium
   # @private

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 6.2.0
+  version: 6.3.0
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-26 00:00:00.000000000 Z
+date: 2023-03-14 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.44.0
+        version: 1.47.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.44.0
+        version: 1.47.0
 - !ruby/object:Gem::Dependency
   name: appium_thor
   requirement: !ruby/object:Gem::Requirement
@@ -259,6 +259,7 @@ files:
 - lib/appium_lib_core/mac2/bridge.rb
 - lib/appium_lib_core/mac2/device.rb
 - lib/appium_lib_core/mac2/device/screen.rb
+- lib/appium_lib_core/support/event_firing_bridge.rb
 - lib/appium_lib_core/version.rb
 - lib/appium_lib_core/windows.rb
 - lib/appium_lib_core/windows/bridge.rb