appium_lib 9.7.5 → 9.8.1

data/lib/appium_lib/core/android/espresso/bridge.rb

@@ -1,18 +0,0 @@
-require_relative '../../android_espresso'
-
-module Appium
-  module Core
-    module Android
-      module Espresso
-        module Bridge
-          def self.for(target)
-            target.extend Appium::Android::Device
-            Core::Android::SearchContext.extend
-
-            Core::Android::Touch.extend_touch_actions
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/android/search_context.rb

@@ -1,17 +0,0 @@
-module Appium
-  module Core
-    module Android
-      module SearchContext
-        # @!method uiautomator_find
-        #   find_element/s can be used with a [UISelector](http://developer.android.com/tools/help/uiautomator/UiSelector.html).
-        #
-        #   ```ruby
-        #    find_elements :uiautomator, 'new UiSelector().clickable(true)'
-        #   ```
-        def self.extend
-          ::Appium::Core::Base::SearchContext.add_finders(uiautomator: '-android uiautomator')
-        end
-      end # class << self
-    end # module Ios
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/android/touch.rb

@@ -1,15 +0,0 @@
-module Appium
-  module Core
-    module Android
-      module Touch
-        def self.extend_touch_actions
-          ::Appium::Core::TouchAction.class_eval do
-            def swipe_coordinates(start_x: 0, start_y: 0, offset_x: 0, offset_y: 0)
-              { offset_x: (start_x + offset_x), offset_y: (start_y + offset_y) }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/android/uiautomator1/bridge.rb

@@ -1,18 +0,0 @@
-require_relative '../../android'
-
-module Appium
-  module Core
-    module Android
-      module Uiautomator1
-        module Bridge
-          def self.for(target)
-            target.extend Appium::Android::Device
-            Core::Android::SearchContext.extend
-
-            Core::Android::Touch.extend_touch_actions
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/android/uiautomator2/bridge.rb

@@ -1,18 +0,0 @@
-require_relative '../../android_uiautomator2'
-
-module Appium
-  module Core
-    module Android
-      module Uiautomator2
-        module Bridge
-          def self.for(target)
-            target.extend Appium::Android::Device
-            Core::Android::SearchContext.extend
-
-            Core::Android::Touch.extend_touch_actions
-          end
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/android_espresso.rb

@@ -1,5 +0,0 @@
-# loaded in common/driver.rb
-require_relative 'android/search_context'
-require_relative 'android/device'
-require_relative 'android/touch'
-require_relative 'android/espresso/bridge'

data/lib/appium_lib/core/android_uiautomator2.rb

@@ -1,5 +0,0 @@
-# loaded in common/driver.rb
-require_relative 'android/search_context'
-require_relative 'android/device'
-require_relative 'android/touch'
-require_relative 'android/uiautomator2/bridge'

data/lib/appium_lib/core/common.rb

@@ -1,6 +0,0 @@
-require_relative 'common/logger'
-require_relative 'common/error'
-require_relative 'common/log'
-require_relative 'common/command'
-require_relative 'common/device'
-require_relative 'common/base'

data/lib/appium_lib/core/common/base.rb

@@ -1,8 +0,0 @@
-# The following files have selenium-webdriver related stuff.
-require_relative 'base/driver'
-require_relative 'base/bridge'
-require_relative 'base/capabilities'
-require_relative 'base/http_default'
-require_relative 'base/search_context'
-require_relative 'base/command'
-require_relative 'base/wait'

data/lib/appium_lib/core/common/base/bridge.rb

@@ -1,47 +0,0 @@
-module Appium
-  module Core
-    class Base
-      class Bridge < ::Selenium::WebDriver::Remote::Bridge
-        def self.handshake(**opts)
-          desired_capabilities = opts.delete(:desired_capabilities)
-
-          if desired_capabilities.is_a?(Symbol)
-            unless Remote::Capabilities.respond_to?(desired_capabilities)
-              raise Error::WebDriverError, "invalid desired capability: #{desired_capabilities.inspect}"
-            end
-            desired_capabilities = Remote::Capabilities.__send__(desired_capabilities)
-          end
-
-          bridge = new(opts)
-          capabilities = bridge.create_session(desired_capabilities)
-
-          case bridge.dialect
-          when :oss
-            CoreBridgeOSS.new(capabilities, bridge.session_id, opts)
-          when :w3c
-            CoreBridgeW3C.new(capabilities, bridge.session_id, opts)
-          else
-            raise CoreError, 'cannot understand dialect'
-          end
-        end
-      end # class Bridge
-
-      class CoreBridgeOSS < ::Selenium::WebDriver::Remote::OSS::Bridge
-        def commands(command)
-          ::Appium::Core::Commands::COMMANDS_EXTEND_OSS[command]
-        end
-      end # class CoreBridgeOSS
-
-      class CoreBridgeW3C < ::Selenium::WebDriver::Remote::W3C::Bridge
-        def commands(command)
-          case command
-          when :status, :is_element_displayed
-            ::Appium::Core::Commands::COMMANDS_EXTEND_OSS[command]
-          else
-            ::Appium::Core::Commands::COMMANDS_EXTEND_W3C[command]
-          end
-        end
-      end # class CoreBridgeW3C
-    end # class Base
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/common/base/capabilities.rb

@@ -1,16 +0,0 @@
-module Appium
-  module Core
-    class Base
-      module Capabilities
-        # @private
-        # @param [Hash] opts_caps Capabilities for Appium server. All capability keys are converted to lowerCamelCase when
-        #                         this client sends capabilities to Appium server as JSON format.
-        # @return [::Selenium::WebDriver::Remote::W3C::Capabilities] Return instance of Appium::Core::Base::Capabilities
-        #                         inherited ::Selenium::WebDriver::Remote::W3C::Capabilities
-        def self.create_capabilities(opts_caps = {})
-          ::Selenium::WebDriver::Remote::W3C::Capabilities.new(opts_caps)
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/common/base/command.rb

@@ -1,10 +0,0 @@
-module Appium
-  module Core
-    class Base
-      module Commands
-        OSS = ::Selenium::WebDriver::Remote::OSS::Bridge::COMMANDS.freeze
-        W3C = ::Selenium::WebDriver::Remote::W3C::Bridge::COMMANDS.freeze
-      end # module Commands
-    end # module Base
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/common/base/driver.rb

@@ -1,40 +0,0 @@
-require_relative 'search_context'
-
-module Appium
-  module Core
-    class Base
-      class Driver < ::Selenium::WebDriver::Driver
-        include ::Selenium::WebDriver::DriverExtensions::UploadsFiles
-        include ::Selenium::WebDriver::DriverExtensions::TakesScreenshot
-        include ::Selenium::WebDriver::DriverExtensions::HasSessionId
-        include ::Selenium::WebDriver::DriverExtensions::Rotatable
-        include ::Selenium::WebDriver::DriverExtensions::HasRemoteStatus
-        include ::Selenium::WebDriver::DriverExtensions::HasWebStorage
-
-        include ::Appium::Core::Base::SearchContext
-
-        def initialize(opts = {})
-          listener = opts.delete(:listener)
-          @bridge = ::Appium::Core::Base::Bridge.handshake(opts)
-          if @bridge.dialect == :oss
-            extend ::Selenium::WebDriver::DriverExtensions::HasTouchScreen
-            extend ::Selenium::WebDriver::DriverExtensions::HasLocation
-            extend ::Selenium::WebDriver::DriverExtensions::HasNetworkConnection
-          end
-          super(@bridge, listener: listener)
-        end
-
-        # Get the device window's size.
-        # @return [Selenium::WebDriver::Dimension]
-        #
-        # @example
-        #   size = @driver.window_size
-        #   size.width #=> Integer
-        #   size.height #=> Integer
-        def window_size
-          manage.window.size
-        end
-      end # class Driver
-    end # class Base
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/common/base/http_default.rb

@@ -1,12 +0,0 @@
-module Appium
-  module Core
-    class Base
-      module Http
-        class Default < Selenium::WebDriver::Remote::Http::Default
-          # TODO: when divide the core to the other gem, then update here. appium/ruby_lib_core/#{version}
-          DEFAULT_HEADERS = { 'Accept' => CONTENT_TYPE, 'User-Agent' => 'appium/ruby_lib_core/0.0.0' }.freeze
-        end
-      end
-    end
-  end
-end

data/lib/appium_lib/core/common/base/search_context.rb

@@ -1,89 +0,0 @@
-module Appium
-  module Core
-    class Base
-      module SearchContext
-        # referenced: ::Selenium::WebDriver::SearchContext
-
-        FINDERS = ::Selenium::WebDriver::SearchContext::FINDERS.merge(accessibility_id: 'accessibility id')
-
-        def self.add_finders(finders)
-          FINDERS.merge!(finders)
-        end
-
-        #
-        # Find the first element matching the given arguments
-        #
-        # @overload find_element(how, what)
-        #   @param [Symbol, String] how The method to find the element by
-        #   @param [String] what The locator to use
-        # @overload find_element(opts)
-        #   @param [Hash] opts Find options
-        #   @option opts [Symbol] :how Key named after the method to find the element by, containing the locator
-        # @return [Element]
-        #
-        # @raise [Error::NoSuchElementError] if the element doesn't exist
-        #
-        # @example Find element with accessibility id
-        #    find_elements :accessibility_id, 'Animation'
-        #    find_elements :accessibility_id, 'Animation'
-        #
-        def find_element(*args)
-          how, what = extract_args(args)
-          by = _set_by_from_finders(how)
-          begin
-            bridge.find_element_by by, what.to_s, ref
-          rescue Selenium::WebDriver::Error::TimeOutError
-            raise Selenium::WebDriver::Error::NoSuchElementError
-          end
-        end
-
-        #
-        # Find all elements matching the given arguments
-        #
-        # @see SearchContext#find_element
-        #
-        def find_elements(*args)
-          how, what = extract_args(args)
-          by = _set_by_from_finders(how)
-          begin
-            bridge.find_elements_by by, what.to_s, ref
-          rescue Selenium::WebDriver::Error::TimeOutError
-            raise Selenium::WebDriver::Error::NoSuchElementError
-          end
-        end
-
-        private
-
-        def _set_by_from_finders(how)
-          finders = FINDERS
-          by = finders[how.to_sym]
-          raise ArgumentError, "cannot find element by #{how.inspect}" unless by
-          by
-        end
-
-        def extract_args(args)
-          case args.size
-          when 2
-            args
-          when 1
-            arg = args.first
-
-            unless arg.respond_to?(:shift)
-              raise ArgumentError, "expected #{arg.inspect}:#{arg.class} to respond to #shift"
-            end
-
-            # this will be a single-entry hash, so use #shift over #first or #[]
-            arr = arg.dup.shift
-            unless arr.size == 2
-              raise ArgumentError, "expected #{arr.inspect} to have 2 elements"
-            end
-
-            arr
-          else
-            raise ArgumentError, "wrong number of arguments (#{args.size} for 2)"
-          end
-        end
-      end # module SearchContext
-    end # class Base
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/common/base/wait.rb

@@ -1,56 +0,0 @@
-module Appium
-  module Core
-    class Base
-      class Wait < ::Selenium::WebDriver::Wait
-        require 'timeout' # for wait
-
-        def initialize(opts = {})
-          valid_keys = [:timeout, :interval, :message, :ignore, :return_if_true]
-          invalid_keys = []
-          opts.keys.each { |key| invalid_keys << key unless valid_keys.include?(key) }
-          # [:one, :two] => :one, :two
-          unless invalid_keys.empty?
-            raise "Invalid keys #{invalid_keys.to_s[1..-2]}. Valid keys are #{valid_keys.to_s[1..-2]}"
-          end
-
-          @timeout        = opts.fetch(:timeout, DEFAULT_TIMEOUT)
-          @interval       = opts.fetch(:interval, DEFAULT_INTERVAL)
-          @message        = opts[:message]
-          @ignored        = Array(opts[:ignore] || ::Exception)
-          @return_if_true = opts[:return_if_true]
-
-          super(timeout: @timeout, interval: @interval, message: @message, ignore: @ignored)
-        end
-
-        # Wait code from the selenium Ruby gem
-        # https://github.com/SeleniumHQ/selenium/blob/cf501dda3f0ed12233de51ce8170c0e8090f0c20/rb/lib/selenium/webdriver/common/wait.rb
-        # @override
-        def until
-          end_time   = Time.now + @timeout
-          last_error = nil
-
-          until Time.now > end_time
-            begin
-              return yield unless @return_if_true
-
-              result = yield
-              return result if result
-            rescue ::Errno::ECONNREFUSED => e
-              raise e
-            rescue *@ignored => last_error # rubocop:disable Lint/HandleExceptions
-              # swallowed
-            end
-
-            sleep @interval
-          end
-
-          msg = @message ? @message.dup : "timed out after #{@timeout} seconds"
-
-          msg << " (#{last_error.message})" if last_error
-
-          raise Selenium::WebDriver::Error::TimeOutError, msg
-        end
-      end # module Wait
-    end # module Base
-  end # module Core
-end # module Appium

data/lib/appium_lib/core/common/command.rb

@@ -1,75 +0,0 @@
-require_relative 'base/command'
-
-module Appium
-  module Core
-    # ref: https://github.com/appium/appium-base-driver/blob/master/lib/mjsonwp/routes.js
-    module Commands
-      COMMAND_NO_ARG = {
-        # Common
-        shake:                      [:post, 'session/:session_id/appium/device/shake'.freeze],
-        launch_app:                 [:post, 'session/:session_id/appium/app/launch'.freeze],
-        close_app:                  [:post, 'session/:session_id/appium/app/close'.freeze],
-        reset:                      [:post, 'session/:session_id/appium/app/reset'.freeze],
-        device_locked?:             [:post, 'session/:session_id/appium/device/is_locked'.freeze],
-        unlock:                     [:post, 'session/:session_id/appium/device/unlock'.freeze],
-        device_time:                [:get,  'session/:session_id/appium/device/system_time'.freeze],
-        current_context:            [:get,  'session/:session_id/context'.freeze],
-
-        # Android
-        open_notifications:         [:post, 'session/:session_id/appium/device/open_notifications'.freeze],
-        toggle_airplane_mode:       [:post, 'session/:session_id/appium/device/toggle_airplane_mode'.freeze],
-        current_activity:           [:get,  'session/:session_id/appium/device/current_activity'.freeze],
-        current_package:            [:get,  'session/:session_id/appium/device/current_package'.freeze],
-        get_system_bars:            [:get,  'session/:session_id/appium/device/system_bars'.freeze],
-        get_display_density:        [:get,  'session/:session_id/appium/device/display_density'.freeze],
-        is_keyboard_shown:          [:get,  'session/:session_id/appium/device/is_keyboard_shown'.freeze],
-        get_network_connection:     [:get,  'session/:session_id/network_connection'.freeze],
-        get_performance_data_types: [:post, 'session/:session_id/appium/performanceData/types'.freeze],
-
-        # iOS
-      }.freeze
-
-      # Some commands differ for each driver.
-      COMMAND = {
-        # common
-        available_contexts:         [:get,  'session/:session_id/contexts'.freeze],
-        set_context:                [:post, 'session/:session_id/context'.freeze],
-        app_strings:                [:post, 'session/:session_id/appium/app/strings'.freeze],
-        lock:                       [:post, 'session/:session_id/appium/device/lock'.freeze],
-        install_app:                [:post, 'session/:session_id/appium/device/install_app'.freeze],
-        remove_app:                 [:post, 'session/:session_id/appium/device/remove_app'.freeze],
-        app_installed?:             [:post, 'session/:session_id/appium/device/app_installed'.freeze],
-        background_app:             [:post, 'session/:session_id/appium/app/background'.freeze],
-        hide_keyboard:              [:post, 'session/:session_id/appium/device/hide_keyboard'.freeze],
-        press_keycode:              [:post, 'session/:session_id/appium/device/press_keycode'.freeze],
-        long_press_keycode:         [:post, 'session/:session_id/appium/device/long_press_keycode'.freeze],
-        set_immediate_value:        [:post, 'session/:session_id/appium/element/:id/value'.freeze],
-        push_file:                  [:post, 'session/:session_id/appium/device/push_file'.freeze],
-        pull_file:                  [:post, 'session/:session_id/appium/device/pull_file'.freeze],
-        pull_folder:                [:post, 'session/:session_id/appium/device/pull_folder'.freeze],
-        get_settings:               [:get,  'session/:session_id/appium/settings'.freeze],
-        update_settings:            [:post, 'session/:session_id/appium/settings'.freeze],
-        touch_actions:              [:post, 'session/:session_id/touch/perform'.freeze],
-        multi_touch:                [:post, 'session/:session_id/touch/multi/perform'.freeze]
-      }.freeze
-
-      COMMAND_ANDROID = {
-        start_activity:             [:post, 'session/:session_id/appium/device/start_activity'.freeze],
-        end_coverage:               [:post, 'session/:session_id/appium/app/end_test_coverage'.freeze],
-        set_network_connection:     [:post, 'session/:session_id/network_connection'.freeze],
-        get_performance_data:       [:post, 'session/:session_id/appium/getPerformanceData'.freeze]
-      }.freeze
-
-      COMMAND_IOS = {
-        touch_id:                   [:post, 'session/:session_id/appium/simulator/touch_id'.freeze],
-        toggle_touch_id_enrollment: [:post, 'session/:session_id/appium/simulator/toggle_touch_id_enrollment'.freeze]
-      }.freeze
-
-      COMMANDS = {}.merge(COMMAND).merge(COMMAND_ANDROID).merge(COMMAND_IOS)
-                   .merge(COMMAND_NO_ARG).freeze
-
-      COMMANDS_EXTEND_OSS = COMMANDS.merge(::Appium::Core::Base::Commands::OSS).freeze
-      COMMANDS_EXTEND_W3C = COMMANDS.merge(::Appium::Core::Base::Commands::W3C).freeze
-    end
-  end
-end