appium_lib 9.6.1 → 9.7.0

data/lib/appium_lib/android/client_xpath.rb

@@ -1,51 +0,0 @@
-require 'nokogiri'
-
-module Appium
-  module Android
-    def _nodeset_to_uiselector(opts = {})
-      results = ''
-
-      nodes = opts[:nodes]
-      first = opts[:first]
-
-      nodes = [nodes[0]] if first
-
-      nodes.each do |node|
-        results += %(new UiSelector().className("#{node.name}").instance(#{node.attr('instance')});)
-      end
-
-      results.strip
-    end
-
-    def _client_xpath(opts = {})
-      root_node = Nokogiri::XML(get_source).children.first
-
-      instance = Hash.new(-1)
-
-      root_node.traverse do |node|
-        number = instance[node.name] += 1
-        node.set_attribute 'instance', number
-      end
-
-      nodes = root_node.xpath(opts[:xpath])
-      first = opts[:first]
-
-      _nodeset_to_uiselector nodes: nodes, first: first
-    end
-
-    # @deprecated Please use :uiautomator or :xpath strategy directly
-    def client_xpath(xpath)
-      warn '[DEPRECATION] client_xpath will be removed. Please use :uiautomator or :xpath strategy directly.'
-      find_element :uiautomator, _client_xpath(xpath: xpath, first: true)
-    end
-
-    # @deprecated Please use :uiautomator or :xpath strategy directly
-    def client_xpaths(xpath)
-      warn '[DEPRECATION] client_xpaths will be removed. Please use :uiautomator or :xpath strategy directly.'
-      find_elements :uiautomator, _client_xpath(xpath: xpath, first: false)
-    end
-  end
-end
-
-# http://stackoverflow.com/questions/9199415/getting-first-node-in-xpath-result-set
-# '(//android.widget.TextView)[1]' not '//android.widget.TextView[1]'

data/lib/appium_lib/android/device.rb

@@ -1,39 +0,0 @@
-require 'base64'
-
-module Appium
-  module Android
-    module Device
-      extend Forwardable
-
-      # @!method hide_keyboard
-      #   Hide the onscreen keyboard
-      #   @param [String] close_key The name of the key which closes the keyboard.
-      #     Defaults to 'Done' for iOS(except for XCUITest).
-      #   @param [Symbol] strategy The symbol of the strategy which closes the keyboard.
-      #     XCUITest ignore this argument.
-      #     Default for iOS is `:pressKey`. Default for Android is `:tapOutside`.
-      #  ```ruby
-      #  hide_keyboard # Close a keyboard with the 'Done' button
-      #  hide_keyboard('Finished') # Close a keyboard with the 'Finished' button
-      #  hide_keyboard(nil, :tapOutside) # Close a keyboard with tapping out side of keyboard
-      #  ```
-
-      class << self
-        def extended(_mod)
-          ::Appium::Device.extend_webdriver_with_forwardable
-
-          ::Appium::Device.add_endpoint_method(:hide_keyboard) do
-            def hide_keyboard(close_key = nil, strategy = nil)
-              option = {}
-
-              option[:key] = close_key if close_key
-              option[:strategy] = strategy || :tapOutside # default to pressKey
-
-              execute :hide_keyboard, {}, option
-            end
-          end
-        end
-      end # class << self
-    end # module Device
-  end # module Android
-end # module Appium

data/lib/appium_lib/android/mobile_methods.rb

@@ -1,15 +0,0 @@
-module Appium
-  module Android
-    class << self
-      # @!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 extended(_mod)
-        ::Appium::Driver::SearchContext::FINDERS[:uiautomator] = '-android uiautomator'
-      end
-    end # class << self
-  end # module Android
-end # module Appium

data/lib/appium_lib/android/patch.rb

@@ -1,16 +0,0 @@
-module Appium
-  module Android
-    # @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 patch_webdriver_element
-      Selenium::WebDriver::Element.class_eval do
-        # Cross platform way of entering text into a textfield
-        def type(text)
-          send_keys text
-        end
-      end
-    end
-  end # Android
-end # Appium

data/lib/appium_lib/capabilities.rb

@@ -1,13 +0,0 @@
-module Appium
-  class Driver
-    module Capabilities
-      # @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::Driver::Capabilities
-      #                         inherited ::Selenium::WebDriver::Remote::W3C::Capabilities
-      def self.init_caps_for_appium(opts_caps = {})
-        ::Selenium::WebDriver::Remote::W3C::Capabilities.new(opts_caps)
-      end
-    end
-  end
-end

data/lib/appium_lib/common/element/window.rb

@@ -1,10 +0,0 @@
-# UIAWindow methods
-module Appium
-  module Common
-    # Get the window's size
-    def window_size
-      return nil if @driver.nil?
-      @driver.manage.window.size
-    end
-  end # module Common
-end # module Appium

data/lib/appium_lib/common/error.rb

@@ -1,8 +0,0 @@
-module Appium
-  module Error
-    class NotSupportedAppiumServer < RuntimeError; end
-
-    # Server side error
-    class ServerError; end
-  end
-end

data/lib/appium_lib/common/patch.rb

@@ -1,190 +0,0 @@
-require_relative 'version'
-
-module Appium
-  module Common
-    # Implement useful features for element.
-    class Selenium::WebDriver::Element # rubocop:disable Style/ClassAndModuleChildren
-      # Note: For testing .text should be used over value, and name.
-
-      # Returns the value attribute
-      #
-      # Fixes NoMethodError: undefined method `value' for Selenium::WebDriver::Element
-      def value
-        attribute :value
-      end
-
-      # Returns the name attribute
-      #
-      # Fixes NoMethodError: undefined method `name' for Selenium::WebDriver::Element
-      def name
-        attribute :name
-      end
-
-      # For use with mobile tap.
-      #
-      # ```ruby
-      # execute_script 'mobile: tap', :x => 0.0, :y => 0.98
-      # ```
-      #
-      # @return [OpenStruct] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }
-      def location_rel(driver = $driver)
-        # TODO: Remove with 'refine Appium ruby binding'
-        #     https://github.com/appium/ruby_lib/issues/602
-        if ::Appium.selenium_webdriver_version_more?('3.4.0')
-          rect   = self.rect
-          location_x = rect.x.to_f
-          location_y = rect.y.to_f
-
-          size_width  = rect.width.to_f
-          size_height = rect.height.to_f
-        else
-          location   = self.location
-          location_x = location.x.to_f
-          location_y = location.y.to_f
-
-          size        = self.size
-          size_width  = size.width.to_f
-          size_height = size.height.to_f
-        end
-
-        center_x = location_x + (size_width / 2.0)
-        center_y = location_y + (size_height / 2.0)
-
-        w = driver.window_size
-        OpenStruct.new(x: "#{center_x} / #{w.width.to_f}",
-                       y: "#{center_y} / #{w.height.to_f}")
-      end
-    end
-  end # module Common
-end # module Appium
-
-# Print JSON posted to Appium. Not scoped to an Appium module.
-#
-# Requires from lib/selenium/webdriver/remote.rb
-require 'selenium/webdriver/remote/capabilities'
-require 'selenium/webdriver/remote/w3c/capabilities'
-require 'selenium/webdriver/remote/bridge'
-require 'selenium/webdriver/remote/oss/bridge'
-require 'selenium/webdriver/remote/w3c/bridge'
-require 'selenium/webdriver/remote/server_error'
-require 'selenium/webdriver/remote/response'
-require 'selenium/webdriver/remote/oss/commands'
-require 'selenium/webdriver/remote/w3c/commands'
-require 'selenium/webdriver/remote/http/common'
-require 'selenium/webdriver/remote/http/default'
-
-# @private
-# Show http calls to the Selenium server.
-#
-# Invaluable for debugging.
-def patch_webdriver_bridge
-  Selenium::WebDriver::Remote::Bridge.class_eval do
-    # Code from lib/selenium/webdriver/remote/bridge.rb
-
-    def execute(command, opts = {}, command_hash = nil)
-      verb, path = commands(command) || raise(ArgumentError, "unknown command: #{command.inspect}")
-      path = path.dup
-
-      path[':session_id'] = @session_id if path.include?(':session_id')
-
-      begin
-        opts.each do |key, value|
-          path[key.inspect] = escaper.escape(value.to_s)
-        end
-      rescue IndexError
-        raise ArgumentError, "#{opts.inspect} invalid for #{command.inspect}"
-      end
-
-      # convert /// into /
-      path.gsub!(/\/+/, '/')
-
-      # change path from session/efac972c-941a-499c-803c-d7d008749/execute
-      # to /execute
-      # path may be nil, session, or not have anything after the session_id.
-      path_str   = path
-      path_str   = '/' + path_str unless path_str.nil? || path_str.length <= 0 || path_str[0] == '/'
-      path_match = path.match(/.*\h{8}-?\h{4}-?\h{4}-?\h{4}-?\h{12}/)
-      path_str   = path.sub(path_match[0], '') unless path_match.nil?
-
-      Appium::Logger.info "#{verb} #{path_str}"
-
-      # must check to see if command_hash is a hash. sometimes it's not.
-      if command_hash.is_a?(Hash) && !command_hash.empty?
-        print_command = command_hash.clone
-
-        print_command.delete :args if print_command[:args] == []
-
-        if print_command[:using] == '-android uiautomator'
-          value                 = print_command[:value].split(';').map { |v| "#{v};" }
-          print_command[:value] = value.length == 1 ? value[0] : value
-
-          # avoid backslash escape quotes in strings. "\"a\"" => "a"
-          Appium::Logger.info print_command.ai.gsub('\"', '"')
-        else
-          Appium::Logger.ap_info print_command
-        end
-      elsif command_hash
-        # non-standard command hash
-        # It's important to output this for debugging problems.
-        # for example invalid JSON will not be a Hash
-        Appium::Logger.ap_info command_hash
-      end
-
-      if !$driver.nil? && $driver.global_webdriver_http_sleep
-        warn '[DEPRECATION] global_webdriver_http_sleep will be removed. Please arrange with timeout.'
-
-        delay = $driver.global_webdriver_http_sleep
-        sleep delay if delay > 0
-      end
-      # Appium::Logger.info "verb: #{verb}, path #{path}, command_hash #{command_hash.to_json}"
-      http.call(verb, path, command_hash)
-    end # def
-  end # class
-end
-
-# Print Appium's origValue error messages.
-# rubocop:disable Style/ClassAndModuleChildren
-# rubocop:disable Style/AndOr
-class Selenium::WebDriver::Remote::Response
-  # @private
-  def error_message
-    val = value
-
-    case val
-    when Hash
-      msg = val['origValue'] || val['message'] or return 'unknown error'
-      msg << ": #{val['alert']['text'].inspect}" if val['alert'].is_a?(Hash) && val['alert']['text']
-      msg << " (#{val['class']})" if val['class']
-    when String
-      msg = val
-    else
-      msg = "unknown error, status=#{status}: #{val.inspect}"
-    end
-
-    msg
-  end
-end
-
-class Selenium::WebDriver::Remote::Http::Common # rubocop:disable Style/ClassAndModuleChildren
-  remove_const :DEFAULT_HEADERS if defined? DEFAULT_HEADERS
-  DEFAULT_HEADERS = { 'Accept' => CONTENT_TYPE, 'User-Agent' => "appium/ruby_lib/#{::Appium::VERSION}" }.freeze
-end
-
-def patch_remote_driver_commands
-  Selenium::WebDriver::Remote::OSS::Bridge.class_eval do
-    def commands(command)
-      ::Appium::Driver::Commands::COMMANDS_EXTEND_OSS[command]
-    end
-  end
-
-  Selenium::WebDriver::Remote::W3C::Bridge.class_eval do
-    def commands(command)
-      case command
-      when :status, :is_element_displayed
-        ::Appium::Driver::Commands::COMMANDS_EXTEND_OSS[command]
-      else
-        ::Appium::Driver::Commands::COMMANDS_EXTEND_W3C[command]
-      end
-    end
-  end
-end

data/lib/appium_lib/common/search_context.rb

@@ -1,10 +0,0 @@
-module Appium
-  class Driver
-    module SearchContext
-      # rubocop:disable Style/MutableConstant
-      FINDERS = {
-        accessibility_id: 'accessibility id'
-      }
-    end
-  end
-end

data/lib/appium_lib/common/version.rb

@@ -1,5 +0,0 @@
-module Appium
-  # Version and Date are defined on the 'Appium' module, not 'Appium::Common'
-  VERSION = '9.6.1'.freeze unless defined? ::Appium::VERSION
-  DATE    = '2017-08-27'.freeze unless defined? ::Appium::DATE
-end

data/lib/appium_lib/device/device.rb

@@ -1,611 +0,0 @@
-require 'base64'
-
-module Appium
-  module Device
-    extend Forwardable
-
-    # @!method app_strings
-    #   Return the hash of all localization strings.
-    #   ```ruby
-    #   app_strings #=> "TransitionsTitle"=>"Transitions", "WebTitle"=>"Web"
-    #   ```
-
-    # @!method background_app
-    #  Backgrounds the app for a set number of seconds.
-    #  This is a blocking application
-    # @param [Integer] seconds How many seconds to background the app for.
-    #
-    #   ```ruby
-    #   background_app
-    #   background_app(5)
-    #   background_app(-1) #=> the app never come back. https://github.com/appium/appium/issues/7741
-    #   ```
-
-    # @!method current_activity
-    #   Get current activity name
-    #   @return [String] An activity name
-    #
-    #   ```ruby
-    #   current_activity # '.ApiDemos'
-    #   ```
-
-    # @!method current_package
-    #   Get current package name
-    #   @return [String] A package name
-    #
-    #   ```ruby
-    #   current_package # 'com.example.android.apis'
-    #   ```
-
-    # @!method get_system_bars
-    #   Get system bar's information
-    #   @return [String] System bar
-    #
-    #   ```ruby
-    #   get_system_bars
-    #   ```
-
-    # @!method get_display_density
-    #   Get connected device's density.
-    #   @return [Integer] The size of density
-    #
-    #   ```ruby
-    #   get_display_density # 320
-    #   ```
-
-    # @!method is_keyboard_shown
-    #   Get whether keyboard is displayed or not.
-    #   @return [Bool] Return true if keyboard is shown. Return false if keyboard is hidden.
-    #
-    #   ```ruby
-    #   is_keyboard_shown # false
-    #   ```
-
-    # @!method launch_app
-    #   Start the simulator and application configured with desired capabilities
-
-    # @!method reset
-    #   Reset the device, relaunching the application.
-
-    # @!method shake
-    #   Cause the device to shake
-
-    # @!method toggle_flight_mode
-    #   Toggle flight mode on or off
-
-    # @!method device_locked?
-
-    # @!method hide_keyboard
-    #   Hide the onscreen keyboard
-    #   @param [String] close_key The name of the key which closes the keyboard.
-    #     Defaults to 'Done' for iOS(except for XCUITest).
-    #   @param [Symbol] strategy The symbol of the strategy which closes the keyboard.
-    #     XCUITest ignore this argument.
-    #     Default for iOS is `:pressKey`. Default for Android is `:tapOutside`.
-    #  ```ruby
-    #  hide_keyboard # Close a keyboard with the 'Done' button
-    #  hide_keyboard('Finished') # Close a keyboard with the 'Finished' button
-    #  hide_keyboard(nil, :tapOutside) # Close a keyboard with tapping out side of keyboard
-    #  ```
-
-    # @!method press_keycode
-    # Press keycode on the device.
-    # http://developer.android.com/reference/android/view/KeyEvent.html
-    # @param [integer] key The key to press.
-    # @param [String] metastate The state the metakeys should be in when pressing the key.
-
-    # @!method long_press_keycode
-    # Long press keycode on the device.
-    # http://developer.android.com/reference/android/view/KeyEvent.html
-    # @param [integer] key The key to long press.
-    # @param [String] metastate The state the metakeys should be in when long pressing the key.
-
-    # @!method push_file
-    #   Place a file in a specific location on the device.
-    #   @param [String] path The absolute path on the device to store data at.
-    #   @param [String] data Raw file data to be sent to the device.
-
-    # @!method pull_file
-    #   Retrieve a file from the device.  This can retrieve an absolute path or
-    #   a path relative to the installed app (iOS only).
-    #   @param [String] path Either an absolute path OR, for iOS devices, a path relative to the app, as described.
-    #
-    #   ```ruby
-    #   pull_file '/local/data/some/path' #=> Get the file at that path
-    #   pull_file 'Shenanigans.app/some/file' #=> Get 'some/file' from the install location of Shenanigans.app
-    #   ```
-
-    # @!method pull_folder
-    #   Retrieve a folder from the device.
-    #   @param [String] path absolute path to the folder
-    #
-    #   ```ruby
-    #   pull_folder '/data/local/tmp' #=> Get the folder at that path
-    #   ```
-
-    # @!method touch_id
-    #   iOS only;  Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
-    #   @param [Boolean] match fingerprint validity
-    #     Defaults to true.
-    #   ```ruby
-    #   touch_id true #=> Simulate valid fingerprint
-    #   touch_id false #=> Simulate invalid fingerprint
-    #   ```
-
-    # @!method toggle_touch_id_enrollment
-    #   iOS Simulator only:  Toggle touch id enrollment on an iOS Simulator.
-
-    # @!method end_coverage
-    #   Android only;  Ends the test coverage and writes the results to the given path on device.
-    #   @param [String] path Path on the device to write too.
-    #   @param [String] intent Intent to broadcast when ending coverage.
-
-    # @!method get_settings
-    #   Get appium Settings for current test session
-
-    # @!method update_settings
-    #   Update appium Settings for current test session
-    #   @param [Hash] settings Settings to update, keys are settings, values to value to set each setting to
-
-    # @!method start_activity
-    #   Start a new activity within the current app or launch a new app and start the target activity.
-    #
-    #   Android only.
-    #   @option [String] The package owning the activity [required]
-    #   @option [String] The target activity [required]
-    #   @option opts [String] The package to start before the target package [optional]
-    #   @option opts [String] The activity to start before the target activity [optional]
-    #
-    #   ```ruby
-    #   start_activity app_package: 'io.appium.android.apis',
-    #     app_activity: '.accessibility.AccessibilityNodeProviderActivity'
-    #   ```
-
-    # @!method get_network_connection
-    #   Get the device network connection current status
-    #   See set_network_connection method for return value
-
-    # @!method set_network_connection
-    #   Set the device network connection mode
-    #   @param [String] path Bit mask that represent the network mode
-    #
-    #   Value (Alias)      | Data | Wifi | Airplane Mode
-    #   -------------------------------------------------
-    #   1 (Airplane Mode)  | 0    | 0    | 1
-    #   6 (All network on) | 1    | 1    | 0
-    #   4 (Data only)      | 1    | 0    | 0
-    #   2 (Wifi only)      | 0    | 1    | 0
-    #   0 (None)           | 0    | 0    | 0
-    #
-
-    # @!method set_immediate_value
-    #   Set the value to element directly
-    #   for iOS; setValue is called in XCUITest instead because XCUITest doesn't provide set value directly.
-    #   https://github.com/appium/appium-xcuitest-driver/blob/793cdc7d5e84bd553e375076e1c6dc7e242c9cde/lib/commands/element.js#L123
-    #
-    #   ```ruby
-    #   set_immediate_value element, 'hello'
-    #   ```
-
-    # @!method get_performance_data_types
-    #   Get the information type of the system state which is supported to read such as
-    #   cpu, memory, network, battery via adb commands.
-    #   https://github.com/appium/appium-base-driver/blob/be29aec2318316d12b5c3295e924a5ba8f09b0fb/lib/mjsonwp/routes.js#L300
-    #
-    #   ```ruby
-    #   get_performance_data_types #=> ["cpuinfo", "batteryinfo", "networkinfo", "memoryinfo"]
-    #   ```
-
-    # @!method get_performance_data
-    #   Get the resource usage information of the application.
-    #   https://github.com/appium/appium-base-driver/blob/be29aec2318316d12b5c3295e924a5ba8f09b0fb/lib/mjsonwp/routes.js#L303
-    #   @param [String] package_name Package name
-    #   @param [String] data_type Data type get with `get_performance_data_types`
-    #   @param [String] data_read_timeout Command timeout. Default is 2.
-    #
-    #   ```ruby
-    #   get_performance_data package_name: package_name, data_type: data_type, data_read_timeout: 2
-    #   ```
-    class << self
-      def extended(_mod)
-        extend_webdriver_with_forwardable
-
-        ::Appium::Driver::Commands::COMMAND_NO_ARG.each_key do |method|
-          add_endpoint_method method
-        end
-
-        add_endpoint_method(:available_contexts) do
-          def available_contexts
-            # return empty array instead of nil on failure
-            execute(:available_contexts, {}) || []
-          end
-        end
-
-        add_endpoint_method(:app_strings) do
-          def app_strings(language = nil)
-            opts = language ? { language: language } : {}
-            execute :app_strings, {}, opts
-          end
-        end
-
-        add_endpoint_method(:lock) do
-          def lock(duration)
-            execute :lock, {}, seconds: duration
-          end
-        end
-
-        add_endpoint_method(:install_app) do
-          def install_app(path)
-            execute :install_app, {}, appPath: path
-          end
-        end
-
-        add_endpoint_method(:remove_app) do
-          def remove_app(id)
-            execute :remove_app, {}, appId: id
-          end
-        end
-
-        add_endpoint_method(:app_installed?) do
-          def app_installed?(app_id)
-            execute :app_installed?, {}, bundleId: app_id
-          end
-        end
-
-        add_endpoint_method(:background_app) do
-          def background_app(duration = 0)
-            execute :background_app, {}, seconds: duration
-          end
-        end
-
-        add_endpoint_method(:start_activity) do
-          def start_activity(opts)
-            raise 'opts must be a hash' unless opts.is_a? Hash
-            app_package = opts[:app_package]
-            raise 'app_package is required' unless app_package
-            app_activity = opts[:app_activity]
-            raise 'app_activity is required' unless app_activity
-            app_wait_package  = opts.fetch(:app_wait_package, '')
-            app_wait_activity = opts.fetch(:app_wait_activity, '')
-
-            unknown_opts = opts.keys - [:app_package, :app_activity, :app_wait_package, :app_wait_activity]
-            raise "Unknown options #{unknown_opts}" unless unknown_opts.empty?
-
-            execute :start_activity, {}, appPackage: app_package,
-                                         appActivity: app_activity,
-                                         appWaitPackage: app_wait_package,
-                                         appWaitActivity: app_wait_activity
-          end
-        end
-
-        add_endpoint_method(:set_context) do
-          def set_context(context = null)
-            execute :set_context, {}, name: context
-          end
-        end
-
-        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
-
-        add_endpoint_method(:press_keycode) do
-          def press_keycode(key, metastate = nil)
-            args             = { keycode: key }
-            args[:metastate] = metastate if metastate
-            execute :press_keycode, {}, args
-          end
-        end
-
-        add_endpoint_method(:long_press_keycode) do
-          def long_press_keycode(key, metastate = nil)
-            args             = { keycode: key }
-            args[:metastate] = metastate if metastate
-            execute :long_press_keycode, {}, args
-          end
-        end
-
-        add_endpoint_method(:set_immediate_value) do
-          def set_immediate_value(element, *value)
-            keys = ::Selenium::WebDriver::Keys.encode(value)
-            execute :set_immediate_value, { id: element.ref }, value: Array(keys)
-          end
-        end
-
-        add_endpoint_method(:push_file) do
-          def push_file(path, filedata)
-            encoded_data = Base64.encode64 filedata
-            execute :push_file, {}, path: path, data: encoded_data
-          end
-        end
-
-        add_endpoint_method(:pull_file) do
-          def pull_file(path)
-            data = execute :pull_file, {}, path: path
-            Base64.decode64 data
-          end
-        end
-
-        # TODO: TEST ME
-        add_endpoint_method(:pull_folder) do
-          def pull_folder(path)
-            data = execute :pull_folder, {}, path: path
-            Base64.decode64 data
-          end
-        end
-
-        # TODO: TEST ME
-        add_endpoint_method(:touch_id) do
-          def touch_id(match = true)
-            execute :touch_id, {}, match: match
-          end
-        end
-
-        # TODO: TEST ME
-        add_endpoint_method(:toggle_touch_id_enrollment) do
-          def toggle_touch_id_enrollment
-            execute :toggle_touch_id_enrollment, {}
-          end
-        end
-
-        # TODO: TEST ME
-        add_endpoint_method(:end_coverage) do
-          def end_coverage(path, intent)
-            execute :end_coverage, {}, path: path, intent: intent
-          end
-        end
-
-        add_endpoint_method(:get_settings) do
-          def get_settings
-            execute :get_settings, {}
-          end
-        end
-
-        add_endpoint_method(:update_settings) do
-          def update_settings(settings)
-            execute :update_settings, {}, settings: settings
-          end
-        end
-
-        add_endpoint_method(:set_network_connection) do
-          def set_network_connection(mode)
-            execute :set_network_connection, {}, type: mode
-          end
-        end
-
-        add_endpoint_method(:get_performance_data) do
-          def get_performance_data(package_name:, data_type:, data_read_timeout: 1000)
-            execute :get_performance_data, {}, packageName: package_name,
-                                               dataType: data_type,
-                                               dataReadTimeout: data_read_timeout
-          end
-        end
-
-        add_touch_actions
-        add_ime_actions
-        extend_search_contexts
-      end
-
-      # def extended
-
-      # @private
-      def add_endpoint_method(method)
-        block_given? ? create_bridge_command(method, &Proc.new) : create_bridge_command(method)
-
-        delegate_driver_method method
-        delegate_from_appium_driver method
-      end
-
-      # @private
-      def extend_webdriver_with_forwardable
-        return if Selenium::WebDriver::Driver.is_a? Forwardable
-        Selenium::WebDriver::Driver.class_eval do
-          extend Forwardable
-        end
-      end
-
-      # @private
-      def delegate_driver_method(method)
-        return if Selenium::WebDriver::Driver.method_defined? method
-        Selenium::WebDriver::Driver.class_eval { def_delegator :@bridge, method }
-      end
-
-      # @private
-      def delegate_from_appium_driver(method, delegation_target = :driver)
-        def_delegator delegation_target, method
-      end
-
-      # @private
-      def create_bridge_command(method)
-        Selenium::WebDriver::Remote::OSS::Bridge.class_eval do
-          block_given? ? class_eval(&Proc.new) : define_method(method) { execute method }
-        end
-
-        Selenium::WebDriver::Remote::W3C::Bridge.class_eval do
-          block_given? ? class_eval(&Proc.new) : define_method(method) { execute method }
-        end
-      end
-
-      # @!method find_element_with_appium
-      # @!method find_elements_with_appium
-      #
-      #   find_element/s_with_appium with their accessibility_id
-      #
-      #   ```ruby
-      #    find_elements :accessibility_id, 'Animation'
-      #   ```
-      def extend_search_contexts
-        Selenium::WebDriver::SearchContext.class_eval do
-          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
-
-          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
-
-          def _set_by_from_finders(how)
-            finders = ::Selenium::WebDriver::SearchContext::FINDERS.merge ::Appium::Driver::SearchContext::FINDERS
-            by = finders[how.to_sym]
-            raise ArgumentError, "cannot find element by #{how.inspect}" unless by
-            by
-          end
-        end
-      end
-
-      def add_touch_actions
-        add_endpoint_method(:touch_actions) do
-          def touch_actions(actions)
-            actions = { actions: [actions].flatten }
-            execute :touch_actions, {}, actions
-          end
-        end
-
-        add_endpoint_method(:multi_touch) do
-          def multi_touch(actions)
-            execute :multi_touch, {}, actions: actions
-          end
-        end
-
-        actions = Appium::TouchAction::COMPLEX_ACTIONS
-        actions.each do |method|
-          delegate_from_appium_driver(method, Appium::TouchAction)
-        end
-
-        delegate_from_appium_driver(:pinch, Appium::MultiTouch)
-        delegate_from_appium_driver(:zoom, Appium::MultiTouch)
-      end
-
-      def add_ime_actions
-        # Commands for IME are defined in the following commands.rb, but the driver have no bridge.
-        # So, appium_lib define just bridge here.
-        # https://github.com/SeleniumHQ/selenium/blob/selenium-3.0.1/rb/lib/selenium/webdriver/remote/commands.rb#L184-L192
-
-        # @!method ime_activate
-        #   Make an engine that is available active.
-        #
-        #   Android only.
-        #   @param [String] The IME owning the activity [required]
-        #
-        #   ```ruby
-        #   ime_activate engine: 'com.android.inputmethod.latin/.LatinIME'
-        #   ```
-        add_endpoint_method(:ime_activate) do
-          def ime_activate(ime_name)
-            execute :ime_activate, {}, engine: ime_name
-          end
-        end
-
-        # @!method ime_available_engines
-        #   List all available input engines on the machine.
-        #   Android only.
-        #
-        #   ```ruby
-        #   ime_available_engines #=> Get the list of IME installed in the target device
-        #   ```
-        add_endpoint_method(:ime_available_engines) do
-          def ime_available_engines
-            execute :get_ime_available_engines
-          end
-        end
-
-        # @!method ime_active_engine
-        #   Get the name of the active IME engine.
-        #   Android only.
-        #
-        #   ```ruby
-        #   ime_active_engine #=> Get the current active IME such as 'com.android.inputmethod.latin/.LatinIME'
-        #   ```
-        add_endpoint_method(:ime_active_engine) do
-          def ime_active_engine
-            execute :get_ime_active_engine
-          end
-        end
-
-        # @!method ime_activated
-        #   Indicates whether IME input is active at the moment (not if it is available).
-        #   Android only.
-        #
-        #   ```ruby
-        #   ime_activated #=> True if IME is activated
-        #   ```
-        add_endpoint_method(:ime_activated) do
-          def ime_activated
-            execute :get_ime_activated
-          end
-        end
-
-        # @!method ime_deactivate
-        #   De-activates the currently-active IME engine.
-        #
-        #   Android only.
-        #
-        #   ```ruby
-        #   ime_deactivate #=> Deactivate current IME engine
-        #   ```
-        add_endpoint_method(:ime_deactivate) do
-          def ime_deactivate
-            execute :ime_deactivate, {}
-          end
-        end
-      end
-    end # class << self
-
-    # @!method set_context
-    #   Change the context to the given context.
-    #   @param [String] The context to change to
-    #
-    #   ```ruby
-    #   set_context "NATIVE_APP"
-    #   ```
-
-    # @!method current_context
-    #   @return [String] The context currently being used.
-
-    # @!method available_contexts
-    #   @return [Array<String>] All usable contexts, as an array of strings.
-
-    # Perform a block within the given context, then switch back to the starting context.
-    # @param context (String) The context to switch to for the duration of the block.
-    #
-    # ```ruby
-    # result = within_context('NATIVE_APP') do
-    #   find_element :tag, "button"
-    # end # The result of `find_element :tag, "button"`
-    # ```
-    def within_context(context)
-      existing_context = current_context
-      set_context context
-      if block_given?
-        result = yield
-        set_context existing_context
-        result
-      else
-        set_context existing_context
-      end
-    end
-
-    # Change to the default context.  This is equivalent to `set_context nil`.
-    def switch_to_default_context
-      set_context nil
-    end
-  end # module Device
-end # module Appium