appium_lib 0.24.1 → 1.0.0

data/android_tests/lib/android/specs/common/patch.rb

@@ -0,0 +1,69 @@
+=begin
+  Skip:
+    status # status patches are already tested in driver.rb
+    raw_execute # debug output for Pry
+=end
+describe 'common/patch' do
+# Attributes are busted in Android.
+# Blocked on https://github.com/appium/appium/issues/628
+  describe 'Selenium::WebDriver::Element methods' do
+    # Android supports exactly two string Attributes
+    # .name and .text
+    # https://github.com/appium/appium/blob/ea3450e7f78d1794bab42fa396a387e7b86fd3b3/android/bootstrap/src/io/appium/android/bootstrap/handler/GetAttribute.java#L43
+    # t 'value' do; end # Doesn't work on Android
+
+    t 'name' do
+      wait { first_s_text.name.must_equal 'API Demos' }
+    end
+
+    # t 'tag_name' do; end # Doesn't work on Android
+
+    t 'location_rel' do
+      wait do
+        loc = first_s_text.location_rel
+        loc.x.class.must_equal String
+        loc.y.class.must_equal String
+      end
+    end
+  end
+
+  describe 'common patch' do
+    # By default, the webdriver gem will return message instead of origValue
+    # {"message":"An unknown server-side error occurred while processing the command.","origValue":"Strategy id is not valid."}
+    t 'id error_message' do
+      value = ''
+      begin
+        set_wait 0
+        find_element(:id, 'ok')
+      rescue Exception => e;
+        value = e.message
+      ensure
+        set_wait 30
+      end
+      value = value.split("\n").first.strip
+      exp   = "Could not find an element using supplied strategy. ID `ok` doesn't exist as text or content desc."
+      value.must_equal exp
+    end
+
+    t 'id success' do
+      wait do
+        el = id 'autocomplete_3_button_7' # <string name="autocomplete_3_button_7">Text</string>
+        el.name.must_equal 'Text'
+      end
+    end
+
+    t 'find many elements by resource id' do
+      wait do
+        value = find_elements(:id, 'android:id/text1').length
+        value.must_equal 13
+      end
+    end
+
+    t 'find single element by resource id' do
+      wait do
+        value = id('android:id/text1').text
+        value.must_equal 'Accessibility'
+      end
+    end
+  end
+end

data/android_tests/lib/android/specs/common/version.rb

@@ -0,0 +1,9 @@
+describe 'version.rb' do
+  t '::Appium::VERSION' do
+    ::Appium::VERSION.must_match /(\d+)\.(\d+).(\d+)/
+  end
+
+  t '::Appium::DATE' do
+    ::Appium::DATE.must_match /(\d+)\-(\d+)\-(\d+)/
+  end
+end

data/android_tests/lib/android/specs/driver.rb

@@ -0,0 +1,174 @@
+# rake android[driver]
+describe 'driver' do
+  def is_sauce
+    ENV['UPLOAD_FILE'] && ENV['SAUCE_USERNAME']
+  end
+
+  t 'load_appium_txt' do
+    # __FILE__ is '(eval)' so use env var set by the Rakefile
+    parsed   = Appium.load_appium_txt file: ENV['APPIUM_TXT'], verbose: true
+    apk_name = File.basename parsed[:caps][:app]
+    assert_equal apk_name, 'api.apk'
+  end
+
+  describe 'Appium::Driver attributes' do
+    # attr_reader :default_wait, :app_path, :app_name, :selendroid,
+    #            :app_package, :app_activity, :app_wait_activity,
+    #            :sauce_username, :sauce_access_key, :port, :os, :debug
+    t 'default_wait attr' do
+      set_wait 1
+      default_wait.must_equal 1
+      set_wait # restore default
+    end
+
+    t 'app_path attr' do
+      apk_name = File.basename driver_attributes[:caps][:app]
+      apk_name.must_equal 'api.apk'
+    end
+
+    # Only used for Sauce Labs
+    t 'verify all attributes' do
+      2.times { set_wait 1 } # must set twice to validate last_waits
+      actual              = driver_attributes
+      actual[:caps][:app] = File.basename actual[:caps][:app]
+      expected            = { caps:             { platformName: 'android',
+                                                  app:          'api.apk' },
+                              custom_url:       false,
+                              export_session:   false,
+                              default_wait:     1,
+                              last_waits:       [1, 1],
+                              sauce_username:   nil,
+                              sauce_access_key: nil,
+                              port:             4723,
+                              device:           :android,
+                              debug:            true }
+
+      actual.must_equal expected
+    end
+  end
+
+  describe 'Appium::Driver' do
+    t '@@loaded' do
+      loaded = $driver.class.class_variable_get :@@loaded
+      loaded.must_equal true
+    end
+
+    t '$driver.class' do
+      $driver.class.must_equal Appium::Driver
+    end
+
+    t 'absolute_app_path' do
+      def absolute_app_path path;
+        $driver.class.absolute_app_path path;
+      end
+
+      def validate_path path;
+        absolute_app_path(path).must_equal path;
+      end
+
+      validate_path 'sauce-storage:some_storage_suffix'
+      validate_path 'http://www.saucelabs.com'
+
+      # fake real paths for osx/windows.
+      FakeFS.activate!
+
+      osx_existing_path = '/Users/user/myapp.app'
+      FileUtils.mkdir_p osx_existing_path
+      validate_path osx_existing_path
+
+      # TODO: FakeFS fails on Windows paths due to the drive letters.
+      # Look into how opscode/chef tests this.
+      # windows_existing_path = "C:\\Program Files\\myapp.apk"
+      # FileUtils.mkdir_p windows_existing_path
+      # validate_path windows_existing_path
+
+      FakeFS.deactivate!
+
+      # bundle id test
+      validate_path 'my.bundle.id'
+
+      # relative path test
+      relative_path = File.join __FILE__, ('..' + File::SEPARATOR) * 4, 'api.apk'
+      expected_path = File.expand_path relative_path
+
+      absolute_app_path(relative_path).must_equal expected_path
+
+      # invalid path test
+      invalid_path_errors = false
+      begin
+        absolute_app_path('../../does_not_exist.apk')
+      rescue Exception
+        invalid_path_errors = true
+      ensure
+        invalid_path_errors.must_equal true
+      end
+    end
+  end
+
+  describe 'methods' do
+    t 'status' do
+      appium_server_version['build'].keys.sort.must_equal %w(revision version)
+    end
+
+    t 'server_version' do
+      server_version = appium_server_version['build']['version']
+      if is_sauce
+        server_version.must_match 'Sauce OnDemand'
+      else
+        server_version.must_match /(\d+)\.(\d+).(\d+)/
+      end
+    end
+
+=begin
+  Skip:
+    ios_capabilities # save for iOS tests
+    absolute_app_path # tested already by starting the driver for this test
+    server_url # sauce labs only
+=end
+    t 'restart' do
+      set_wait 1 # ensure wait is 1 before we restart.
+      restart
+      current_activity.must_equal '.ApiDemos'
+    end
+
+    t 'driver' do
+      driver.browser.must_equal :Android
+    end
+
+=begin
+  Skip:
+    screenshot   # this is slow and already tested by Appium
+    driver_quit  # tested by restart
+    start_driver # tested by restart
+    no_wait  # posts value to server, it's not stored locally
+    set_wait # posts value to server, it's not stored locally
+    execute_script # 'mobile: ' is deprecated and plain executeScript unsupported
+=end
+    t 'default_wait' do
+      set_wait 1
+      default_wait.must_equal 1
+    end
+
+    # returns true unless an error is raised
+    t 'exists' do
+      exists(0, 0) { true }.must_equal true
+      exists(0, 0) { raise 'error' }.must_equal false
+    end
+
+    # any elements
+    t 'find_elements' do
+      wait do
+        find_elements(:class_name, 'android.widget.TextView').length.must_equal 14
+      end
+    end
+
+    # any element
+    t 'find_element' do
+      wait do
+        find_element(:class_name, 'android.widget.TextView').class.must_equal Selenium::WebDriver::Element
+      end
+    end
+
+    # Skip: x # x is only used in Pry
+  end
+end

data/android_tests/lib/format.rb

@@ -0,0 +1,49 @@
+# helper code useful for writing and verifying tests using Pry
+list = <<TXT
+find
+text
+texts
+name
+names
+scroll_to
+TXT
+
+list.split("\n").each do |method|
+  puts "t '#{method}' do"
+  puts
+  puts 'end'
+  puts
+end
+
+# --
+
+# Format AndroidElementClassMap from
+# https://github.com/appium/appium/blob/master/android/bootstrap/src/io/appium/android/bootstrap/AndroidElementClassMap.java
+# for ruby_lib android/helper.rb tag_name_to_android
+list = <<TXT
+    map.put("abslist", "AbsListView");
+    map.put("button", "Button");
+TXT
+
+list.split("\n").each do |method|
+  pair  = method.match /"([^"]+)"[^"]+"([^"]+)"/
+  tag   = pair[1]
+  klass = pair[2]
+
+  indent = 6
+  puts ' ' * indent + "when '" + tag + "'"
+  line2 = ' ' * (indent + 2) + "prefix '" + klass + "'"
+  # button must translate to both button and image button
+  # for ruby_lib to find all buttons
+  line2 += ", 'ImageButton'" if klass == 'Button'
+  puts line2
+end
+
+=begin
+# for Pry
+class Object
+  def must_equal b
+    raise 'not equal' unless self == b
+  end
+end
+=end

data/android_tests/lib/run.rb

@@ -0,0 +1,72 @@
+require 'rubygems'
+require 'spec'
+require 'fakefs/safe'
+require_relative '../../lib/appium_lib'
+
+=begin
+Run all Android tests:
+  ruby run.rb android
+
+Run only the view album test:
+  ruby run.rb android view_album
+=end
+
+# Sanity check
+a = OpenStruct.new x: 'ok'
+raise 'x issue' unless a.x == 'ok'
+
+dir     = File.expand_path '..', __FILE__
+device  = ARGV[0].downcase.strip
+devices = %w[ android selendroid ios ]
+raise 'Expected android, selendroid or ios as first argument' unless devices.include? device
+
+one_test = ARGV[1]
+test_dir = "/#{device}/"
+
+caps       = Appium.load_appium_txt file: ENV['APPIUM_TXT'], verbose: true
+caps       = caps.merge({ appium_lib: { debug: true, wait: 1 } })
+caps[:app] = ENV['SAUCE_PATH'] if ENV['SAUCE_USERNAME'] && ENV['SAUCE_ACCESS_KEY']
+
+trace_files = []
+
+if one_test
+  unless File.exists? one_test
+    # ensure ext is .rb
+    one_test = File.join(File.dirname(one_test),
+                         File.basename(one_test, '.*') + '.rb')
+    one_test = File.join(dir, test_dir + 'specs/', one_test)
+  else
+    one_test = File.expand_path one_test
+  end
+  raise "\nTest #{one_test} does not exist.\n" unless File.exists?(one_test)
+  Appium::Driver.new(caps).start_driver
+  # require support (common.rb)
+  Dir.glob(File.join dir, test_dir + '/*.rb') do |test|
+    require test
+    trace_files << test
+  end
+  puts "Loading one test: #{one_test}"
+  require one_test
+  trace_files << one_test
+else
+  # require all
+  Dir.glob(File.join dir, test_dir + '**/*.rb') do |test|
+    # load all tests
+    trace_files << test
+    puts "  #{File.basename(test, '.*')}"
+    require test
+  end
+  Appium::Driver.new(caps).start_driver
+end
+
+trace_files.map! do |f|
+  f = File.expand_path f
+  # ensure all traced files end in .rb
+  f = File.join(File.dirname(f), File.basename(f, '.*') + '.rb')
+  f
+end
+
+# Exit after tests.
+Minitest.after_run { $driver.x if $driver }
+# Run Minitest. Provide test file array for tracing.
+Minitest.run_specs({ :trace => trace_files })

data/android_tests/readme.md

@@ -0,0 +1,27 @@
+ruby_lib_android
+=====================
+
+ruby_lib's Android tests. Requires `Ruby 1.9.3` or better.
+
+- `rake install` Install gems required to run the tests.
+- `rake android` Run all tests.
+- `rake android['android/element/generic']` Run a single test.
+- `arc` Opens the Appium Ruby Console (arc). Enables interactive testing.
+  - `gem install appium_console` if it's not installed already.
+
+api.apk is from [appium/android-apidemos](https://github.com/appium/android-apidemos)
+
+#### Documentation
+
+- [Installing Appium on OS X](https://github.com/appium/ruby_console/blob/master/osx.md)
+- [Overview](https://github.com/appium/ruby_lib/blob/master/docs/docs.md) 
+- [Android methods](https://github.com/appium/ruby_lib/blob/master/docs/android_docs.md)
+- [Minitest Expectations](http://ruby-doc.org/stdlib-1.9.3/libdoc/minitest/spec/rdoc/MiniTest/Expectations.html)
+
+--
+
+```java
+Finished in 2 mins 8 secs
+
+94 runs, 120 assertions, 0 failures, 0 errors, 0 skips
+```

data/appium_lib.gemspec

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 def self.add_to_path path
  path = File.expand_path "../#{path}/", __FILE__
 
@@ -24,14 +22,19 @@ 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 'selenium-webdriver', '~> 2.39', '>= 2.39.0'
+  s.add_runtime_dependency 'selenium-webdriver', '~> 2.41', '>= 2.41.0'
   s.add_runtime_dependency 'awesome_print', '~> 1.2', '>= 1.2.0'
   s.add_runtime_dependency 'json', '~> 1.8', '>= 1.8.1'
   s.add_runtime_dependency 'toml', '~> 0.0', '>= 0.0.4'
   s.add_runtime_dependency 'posix-spawn', '~> 0.3', '>= 0.3.8'
+  s.add_runtime_dependency 'nokogiri', '~> 1.6.1'
+
+  s.add_development_dependency 'hashdiff', '~> 0.2.0'
+  s.add_development_dependency 'spec', '~> 5.3.4'
+  s.add_development_dependency 'fakefs', '~> 0.5.0'
 
-  s.add_development_dependency 'rake', '~> 10.0', '>= 10.0.4'
+  s.add_development_dependency 'rake', '~> 10.2', '>= 10.2.2'
   s.add_development_dependency 'yard', '~> 0.8', '>= 0.8.7.3'
 
   s.files = `git ls-files`.split "\n"
-end
+end

data/docs/android_docs.md

@@ -1,941 +1,936 @@
-##### [s_texts](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L10) 
+##### [load_appium_txt](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L71) 
 
-> def s_texts text=nil
+> def self.load_appium_txt opts={}
 
-Get an array of text texts if text is nil else
-Get all static textfields that include text.
+Load appium.txt (toml format)
+the basedir of this file + appium.txt is what's used
+
+```
+[caps]
+app = "path/to/app"
+
+[appium_lib]
+port = 8080
+```
+
+:app is expanded
+:require is expanded
+all keys are converted to symbols
 
 __Parameters:__
 
-     [String] text - the text to find.
+     [Hash] opts - file: '/path/to/appium.txt', verbose: true
 
 __Returns:__
 
-     [Array] 
+     [hash] the symbolized hash with updated :app and :require keys
 
 --
 
-##### [s_texts_names](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L18) 
+##### [symbolize_keys](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L141) 
 
-> def s_texts_names
+> def self.symbolize_keys hash
 
+convert all keys (including nested) to symbols
 
+based on deep_symbolize_keys & deep_transform_keys from rails
+https://github.com/rails/docrails/blob/a3b1105ada3da64acfa3843b164b14b734456a50/activesupport/lib/active_support/core_ext/hash/keys.rb#L84
 
 --
 
-##### [e_s_texts](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L24) 
+##### [promote_singleton_appium_methods](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L151) 
 
-> def e_s_texts
-
-Get an array of text elements.
+> def self.promote_singleton_appium_methods main_module
 
-__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Text>] 
 
 --
 
-##### [first_s_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L30) 
+##### [promote_appium_methods](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L180) 
 
-> def first_s_text
+> def self.promote_appium_methods class_array
 
-Get the first text element.
+Promote appium methods to class instance methods
 
-__Returns:__
+To promote methods to all classes:
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+```ruby
+Appium.promote_appium_methods Object
+```
 
---
+__Parameters:__
 
-##### [last_s_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L36) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Class>] class_array - An array of classes
 
-> def last_s_text
+--
 
-Get the last text element
+##### [global_webdriver_http_sleep](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L213) 
 
-__Returns:__
+> def global_webdriver_http_sleep
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+The amount to sleep in seconds before every webdriver http call.
 
 --
 
-##### [s_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L43) 
+##### [global_webdriver_http_sleep=](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L213) 
 
-> def s_text text
+> def global_webdriver_http_sleep=(value)
 
-Get the first element that includes text.
+The amount to sleep in seconds before every webdriver http call.
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] text - the text to find. If int then the text at that index is returned.
+##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L234) 
 
-__Returns:__
+> def initialize opts={}
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+Creates a new driver
 
---
+```ruby
+require 'rubygems'
+require 'appium_lib'
 
-##### [s_text_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L51) 
+# platformName takes a string or a symbol.
 
-> def s_text_exact text
+# Start iOS driver
+opts = { caps: { platformName: :ios, app: '/path/to/MyiOS.app' } }
+Appium::Driver.new(opts).start_driver
 
-Get the first textfield that matches text.
+# Start Android driver
+opts = { caps: { platformName: :android, app: '/path/to/my.apk' } }
+Appium::Driver.new(apk).start_driver
+```
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text that the tag must match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] opts - A hash containing various options.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Driver] 
 
 --
 
-##### [s_texts_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/text.rb#L58) 
+##### [driver_attributes](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L308) 
 
-> def s_texts_exact text
+> def driver_attributes
 
-Get all static textfields that matches text.
+Returns a hash of the driver attributes
+
+--
+
+##### [device_is_android?](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L328) 
+
+> def device_is_android?
 
-__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text that the tag must match
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Text>] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Boolean] 
 
 --
 
-##### [window_size](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/window.rb#L5) 
+##### [appium_server_version](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L344) 
 
-> def window_size
+> def appium_server_version
 
-Get the window's size
+Returns the server's version info
 
---
+```ruby
+{
+    "build" => {
+        "version" => "0.18.1",
+        "revision" => "d242ebcfd92046a974347ccc3a28f0e898595198"
+    }
+}
+```
 
-##### [button](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L8) 
+__Returns:__
 
-> def button text, number=0
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] 
 
-Find a button by text and optionally number.
+--
 
-__Parameters:__
+##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L350) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] text - the text to exactly match. If int then the button at that index is returned.
+> def self.absolute_app_path app_path
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] number - the occurrence of the button matching text. Defaults to the first button.
+Converts app_path to an absolute path.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] the button found with text and matching number
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] APP_PATH as an absolute path
 
 --
 
-##### [buttons](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L19) 
-
-> def buttons text=nil
+##### [server_url](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L374) 
 
-Get an array of button texts or button elements if text is provided.
-
-__Parameters:__
+> def server_url
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to exactly match
+Get the server url
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>, Array<Buttons>] either an array of button texts or an array of button elements if text is provided.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] the server url
 
 --
 
-##### [first_button](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L26) 
+##### [restart](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L385) 
 
-> def first_button
+> def restart
 
-Get the first button element.
+Restarts the driver
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Driver] the driver
 
 --
 
-##### [last_button](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L32) 
+##### [driver](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L392) 
 
-> def last_button
+> def driver
 
-Get the last button element.
+Returns the driver
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Driver] the driver
 
 --
 
-##### [button_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L39) 
+##### [screenshot](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L402) 
 
-> def button_exact text
+> def screenshot png_save_path
+
+Takes a png screenshot and saves to the target path.
 
-Get the first button element that exactly matches text.
+Example: screenshot '/tmp/hi.png'
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match exactly
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] png_save_path - the full path to save the png
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[nil] 
 
 --
 
-##### [buttons_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L46) 
-
-> def buttons_exact text
+##### [driver_quit](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L409) 
 
-Get all button elements that exactly match text.
-
-__Parameters:__
+> def driver_quit
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match exactly
+Quits the driver
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
 --
 
-##### [e_buttons](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L52) 
+##### [start_driver](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L417) 
 
-> def e_buttons
+> def start_driver
 
-Get an array of button elements.
+Creates a new global driver and quits the old one if it exists.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Selenium::WebDriver] the new global driver
 
 --
 
-##### [button_num](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/element/button.rb#L72) 
+##### [no_wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L443) 
+
+> def no_wait
+
+Set implicit wait and default_wait to zero.
 
-> def button_num text, number=1
+--
 
-Expected to be called via button method.
+##### [set_wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L462) 
 
-Get the button element exactly matching text and
-occurrence. number=2 means the 2nd occurrence.
+> def set_wait timeout=nil
 
-find the second Sign In button
+Set implicit wait and default_wait to timeout, defaults to 30.
+if set_wait is called without a param then the second to last
+wait will be used.
 
-b = e_button 'Sign In', 2
+```ruby`
+set_wait 2
+set_wait 3
+set_wait # 2
 
-Button order will change in iOS vs Android
-so if there's no button found at number then
-return the first button.
+````
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] number - the button occurance to return. 1 = first button
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] timeout - the timeout in seconds
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] the button that matches text and number
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
 --
 
-##### [tag_name_to_android](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L6) android
+##### [default_wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L480) 
 
-> def tag_name_to_android tag_name
-
-Returns an array of android classes that match the tag name
-
-__Parameters:__
+> def default_wait
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to convert to an android class
+Returns the default client side wait.
+This value is independent of what the server is using
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] 
 
 --
 
-##### [find_eles_attr](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L198) android
+##### [exists](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L496) 
 
-> def find_eles_attr tag_name, attribute=nil
+> def exists pre_check=0, post_check=@default_wait, &search_block
 
-Find all elements matching the attribute
-On android, assume the attr is name (which falls back to text).
+Returns existence of element.
 
-```ruby
-  find_eles_attr :text
-```
+Example:
+
+exists { button('sign in') } ? puts('true') : puts('false')
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to search for
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] pre_check - the amount in seconds to set the
+wait to before checking existance
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] post_check - the amount in seconds to set the
+wait to after checking existance
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] search_block - the block to call
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Boolean] 
 
 --
 
-##### [get_selendroid_inspect](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L220) android
+##### [execute_script](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L520) 
 
-> def get_selendroid_inspect
+> def execute_script script, *args
 
-Selendroid only.
-Returns a string containing interesting elements.
+The same as @driver.execute_script
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] script - the script to execute
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to pass to the script
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] 
 
 --
 
-##### [get_page_class](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L282) android
-
-> def get_page_class
+##### [find_elements](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L528) 
 
+> def find_elements *args
 
+Calls @driver.find_elements
 
---
+__Parameters:__
 
-##### [page_class](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L310) android
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to use
 
-> def page_class
+__Returns:__
 
-Count all classes on screen and print to stdout.
-Useful for appium_console.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] Array is empty when no elements are found.
 
 --
 
-##### [get_android_inspect](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L319) android
+##### [find_element](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L536) 
+
+> def find_element *args
 
-> def get_android_inspect
+Calls @driver.find_elements
 
-Android only.
-Returns a string containing interesting elements.
-If an element has no content desc or text, then it's not returned by this method.
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to use
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [get_inspect](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L403) android
+##### [x](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L543) 
 
-> def get_inspect
+> def x
 
-Automatically detects selendroid or android.
-Returns a string containing interesting elements.
+Quit the driver and Pry.
+quit and exit are reserved by Pry.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
 --
 
-##### [page](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L409) android
+##### [NoArgMethods](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L7) 
 
-> def page
+> NoArgMethods = {
 
-Intended for use with console.
-Inspects and prints the current page.
 
---
 
-##### [fast_duration](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L421) android
+--
 
-> def fast_duration
+##### [app_strings](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L23) 
 
-JavaScript code from https://github.com/appium/appium/blob/master/app/android.js
+> def app_strings
 
-```javascript
-Math.round(1.0/28.0 * 28) = 1
+Return the hash of all localization strings.
+```ruby
+app_strings #=> "TransitionsTitle"=>"Transitions", "WebTitle"=>"Web"
 ```
 
-We want steps to be exactly 1. If it's zero then a tap is used instead of a swipe.
-
 --
 
-##### [current_app](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L427) android
+##### [background_app](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L29) 
 
-> def current_app
+> def background_app
 
-Lists package, activity, and adb shell am start -n value for current app.
-Works on local host only (not remote).
+Backgrounds the app for a set number of seconds.
+This is a blocking application
 
 --
 
-##### [id](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/helper.rb#L441) android
+##### [current_activity](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L34) 
 
-> def id id
+> def current_activity
 
-Find by id. Useful for selendroid
 
-__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] id - the id to search for
+--
 
-__Returns:__
+##### [launch](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L36) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+> def launch
+
+Start the simulator and applicaton configured with desired capabilities
 
 --
 
-##### [alert_click](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/alert.rb#L6) android
+##### [reset](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L39) 
 
-> def alert_click value
+> def reset
 
-Tap the alert button identified by value.
+Reset the device, relaunching the application.
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer, String] value - either an integer index of the button or the button's name
+##### [shake](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L42) 
 
-__Returns:__
+> def shake
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+Cause the device to shake
 
 --
 
-##### [alert_accept](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/alert.rb#L13) android
+##### [toggle_flight_mode](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L45) 
 
-> def alert_accept
+> def toggle_flight_mode
 
-Accept the alert.
-The last button is considered "accept."
+toggle flight mode on or off
 
-__Returns:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+##### [complex_find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L48) 
 
---
+> def complex_find
 
-##### [alert_accept_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/alert.rb#L20) android
+Find an element by a complex array of criteria.  Available criteria
+are listed in [link here].  Criteria are formed by creating an array
+of arrays, each containing a selector and that selector's value.
 
-> def alert_accept_text
+```ruby
+complex_find [[[2, 'Sau'], [14, true]]] # => Find a clickable element
+                                        #    whose names starts with 'Sau'
+```
 
-Get the text of the alert's accept button.
-The last button is considered "accept."
+__Parameters:__
 
-__Returns:__
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Symbol] mod - If present, will be the 0th element in the selector array.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Object>] selectors - The selectors to find elements with.
 
 --
 
-##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/alert.rb#L27) android
+##### [hide_keyboard](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L60) 
 
-> def alert_dismiss
+> def hide_keyboard
 
-Dismiss the alert.
-The first button is considered "dismiss."
+Hide the onscreen keyboard
 
-__Returns:__
+__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] close_key - the name of the key which closes the keyboard.
+Defaults to 'Done'.
 
 --
 
-##### [alert_dismiss_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/alert.rb#L34) android
+##### [key_event](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L69) 
 
-> def alert_dismiss_text
+> def key_event
 
-Get the text of the alert's dismiss button.
-The first button is considered "dismiss."
+Send a key event to the device.
 
-__Returns:__
+__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[integer] key - The key to send.
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] metastate - The state the metakeys should be in when sending the key.
 
 --
 
-##### [find](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L44) android
+##### [push_file](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L74) 
 
-> def find val
+> def push_file
 
-Find the value contained in content description or text. Search elements
-in this order: EditText, Button, ImageButton
+Place a file in a specific location on the device.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] val - the value to search for
-
-__Returns:__
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] path - The absolute path on the device to store data at.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] data - Raw file data to be sent to the device.
 
 --
 
-##### [text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L70) android
+##### [pull_file](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L79) 
 
-> def text text
+> def pull_file
 
-Return the first element matching text.
+Retrieve a file from the device.  This can retrieve an absolute path or
+a path relative to the installed app (iOS only).
+```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
+```
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the first matching element
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] path - Either an absolute path OR, for iOS devices, a path relative to the app, as described.
 
 --
 
-##### [texts](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L79) android
-
-> def texts text
+##### [extend_search_contexts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L277) 
 
-Return all elements matching text.
+> def extend_search_contexts
 
-__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for
 
-__Returns:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] all matching elements
+##### [accessiblity_id_find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L277) 
 
---
+> def accessiblity_id_find
 
-##### [name](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L88) android
+find_element/s with their accessibility_id
 
-> def name name
+```ruby
+ find_elements :accessibility_id, 'Animation'
+```
 
-Return the first element matching name.
-on Android name is content description
-on iOS name is the accessibility label or the text.
+--
 
-__Parameters:__
+##### [add_touch_actions](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L283) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to search for
+> def add_touch_actions
 
-__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the first matching element
 
 --
 
-##### [name_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L99) android
+##### [current_context=](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L307) 
 
-> def name_exact name
+> def current_context=
 
-Return the first element exactly matching name.
-on Android name is content description
-on iOS name is the accessibility label or the text.
+Change the context to the given context.
+```ruby
+current_context= "NATIVE_APP"
+```
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to search for
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the first matching element
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] The - context to change to
 
 --
 
-##### [names](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L117) android
+##### [current_context](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L315) 
 
-> def names name=''
+> def current_context
 
-Return all elements matching name.
-on Android name is content description
-on iOS name is the accessibility label or the text.
 
-__Parameters:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to search for
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] all matching elements
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] The context currently being used.
 
 --
 
-##### [scroll_to](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L131) android
-
-> def scroll_to text
+##### [available_contexts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L318) 
 
-Scroll to an element containing target text or description.
+> def available_contexts
 
-__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for in the text value and content description
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element scrolled to
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>] All usable contexts, as an array of strings.
 
 --
 
-##### [scroll_to_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/generic.rb#L144) android
+##### [within_context](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L328) 
 
-> def scroll_to_exact text
+> def within_context(context)
 
-Scroll to an element with the exact target text or description.
+Perform a block within the given context, then switch back to the starting context.
+```ruby
+within_context('NATIVE_APP') do
+  find_element [:tag, "button"]
+```
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for in the text value and content description
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element scrolled to
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] context - The context to switch to for the duration of the block.
 
 --
 
-##### [textfields](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/textfield.rb#L7) android
-
-> def textfields
+##### [switch_to_default_context](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L335) 
 
-Get an array of textfield texts.
+> def switch_to_default_context
 
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>] 
+Change to the default context.  This is equivalent to `current_context= nil`.
 
 --
 
-##### [e_textfields](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/textfield.rb#L13) android
+##### [pinch](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L30) 
 
-> def e_textfields
+> def pinch(percentage=25, auto_perform=true)
+
+Convenience method for pinching the screen.
+Places two fingers at the edges of the screen and brings them together.
+```ruby
+action = pinch 75 #=> Pinch the screen from the top right and bottom left corners
+action.perform    #=> to 25% of its size.
+```
 
-Get an array of textfield elements.
+__Parameters:__
 
-__Returns:__
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[int] percentage - The percent size by which to shrink the screen when pinched.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Textfield>] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[boolean] auto_perform - Whether to perform the action immediately (default true)
 
 --
 
-##### [first_textfield](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/textfield.rb#L19) android
+##### [zoom](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L58) 
 
-> def first_textfield
+> def zoom(percentage=200, auto_perform=true)
 
-Get the first textfield element.
+Convenience method for zooming the screen.
+Places two fingers at the edges of the screen and brings them together.
+```ruby
+action = zoom 200 #=> Zoom in the screen from the center until it doubles in size.
+action.perform
+```
 
-__Returns:__
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[int] percentage - The percent size by which to shrink the screen when pinched.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[boolean] auto_perform - Whether to perform the action immediately (default true)
 
 --
 
-##### [last_textfield](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/textfield.rb#L25) android
+##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L79) 
 
-> def last_textfield
+> def initialize
 
-Get the last textfield element.
+Create a new multi-action
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[MultiTouch] a new instance of MultiTouch
 
 --
 
-##### [textfield](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/textfield.rb#L32) android
+##### [add](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L85) 
 
-> def textfield text
+> def add(chain)
 
-Get the first textfield that includes text or name (content description).
+Add a touch_action to be performed
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] text - the text to search for. If int then the textfield at that index is returned.
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[TouchAction] chain - The action to add to the chain
 
 --
 
-##### [textfield_exact](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/android/element/textfield.rb#L45) android
+##### [perform](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L90) 
 
-> def textfield_exact text
+> def perform
 
-Get the first textfield that matches text.
+Ask Appium to perform the actions
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match
+##### [ACTIONS](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L12) 
+
+> ACTIONS = [:move_to, :press_for_duration, :press, :release, :tap, :wait, :perform]
 
-__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
 
 --
 
-##### [wait](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L33) 
+##### [COMPLEX_ACTIONS](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L13) 
 
-> def wait max_wait=30, interval=0.5, &block
+> COMPLEX_ACTIONS = [:swipe]
 
-Check every 0.5 seconds to see if block.call doesn't raise an exception.
-if .call raises an exception then it will be tried again.
-if .call doesn't raise an exception then it will stop waiting.
 
-Example: wait { name('back').click }
 
-Give up after 30 seconds.
+--
 
-__Parameters:__
+##### [actions](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L27) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] max_wait - the maximum time in seconds to wait for.
-Note that max wait 0 means infinity.
+> def actions
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Float] interval - the time in seconds to wait after calling the block
+Returns the value of attribute actions
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] block - the block to call
+--
 
-__Returns:__
+##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L29) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] the result of block.call
+> def initialize
 
---
 
-##### [ignore](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L45) 
 
-> def ignore &block
+__Returns:__
 
-Return block.call and ignore any exceptions.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[TouchAction] a new instance of TouchAction
 
 --
 
-##### [wait_true](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L55) 
+##### [move_to](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L37) 
 
-> def wait_true max_wait=30, interval=0.5, &block
+> def move_to(opts)
 
-Check every 0.5 seconds to see if block.call returns true. nil is considered a failure.
-Give up after 30 seconds.
+Move to the given co-ordinates.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] max_wait - the maximum time in seconds to wait for
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Float] interval - the time in seconds to wait after calling the block
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] block - the block to call
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] the result of block.call
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] opts - a customizable set of options
 
 --
 
-##### [back](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L68) 
+##### [press_for_duration](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L47) 
 
-> def back
-
-Navigate back.
+> def press_for_duration(element, x, y, duration)
 
-__Returns:__
+Press down for a specific duration.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+__Parameters:__
 
---
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[WebDriver::Element] element - the element to press.
 
-##### [session_id](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L73) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[integer] x - x co-ordinate to press on.
 
-> def session_id
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[integer] y - y co-ordinate to press on.
 
-For Sauce Labs reporting. Returns the current session id.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[integer] duration - Number of seconds to press.
 
 --
 
-##### [xpath](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L81) 
+##### [press](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L58) 
 
-> def xpath xpath_str
+> def press(opts)
 
-Returns the first element that matches the provided xpath.
+Press a finger onto the screen.  Finger will stay down until you call
+`release`.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] xpath_str - the XPath string
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] opts - a customizable set of options
 
 --
 
-##### [xpaths](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L89) 
+##### [release](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L69) 
 
-> def xpaths xpath_str
+> def release(opts=nil)
 
-Returns all elements that match the provided xpath.
+Remove a finger from the screen.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] xpath_str - the XPath string
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] opts - a customizable set of options
 
 --
 
-##### [ele_index](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L97) 
+##### [tap](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L80) 
 
-> def ele_index tag_name, index
+> def tap(opts)
 
-Get the element of type tag_name at matching index.
+Touch a point on the screen
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to find
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] index - the index
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the found element of type tag_name
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] opts - a customizable set of options
 
 --
 
-##### [find_eles](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L106) 
+##### [wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L88) 
 
-> def find_eles tag_name
+> def wait(seconds)
 
-Get all elements exactly matching tag name
+Pause for a number of seconds before the next action
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to find
-
-__Returns:__
-
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the found elements of type tag_name
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[integer] seconds - Number of seconds to pause for
 
 --
 
-##### [find_ele_by_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L114) 
+##### [swipe](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L99) 
 
-> def find_ele_by_text tag, text
+> def swipe(opts)
 
-Get the first tag that exactly matches tag and text.
+Convenience method to peform a swipe.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] opts - a customizable set of options
+
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to exactly match
+##### [perform](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L114) 
 
-__Returns:__
+> def perform
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag exactly matching text
+Ask the driver to perform all actions in this action chain.
 
 --
 
-##### [find_eles_by_text](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L122) 
+##### [cancel](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L120) 
 
-> def find_eles_by_text tag, text
+> def cancel
 
-Get all tags that exactly match tag and text.
+Does nothing, currently.
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+##### [chain_method](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L128) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to exactly match
+> def chain_method(method, args=nil)
 
-__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag exactly matching text
 
 --
 
-##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L131) 
+##### [args_with_ele_ref](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L137) 
 
-> def find_ele_by_attr_include tag, attr, value
+> def args_with_ele_ref(args)
 
-Get the first tag by attribute that exactly matches value.
 
-__Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
+##### [wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L33) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must include
+> def wait max_wait=30, interval=0.5, &block
 
-__Returns:__
+Check every 0.5 seconds to see if block.call doesn't raise an exception.
+if .call raises an exception then it will be tried again.
+if .call doesn't raise an exception then it will stop waiting.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag who's attribute includes value
+Example: wait { name('back').click }
 
---
+Give up after 30 seconds.
+
+__Parameters:__
 
-##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L140) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] max_wait - the maximum time in seconds to wait for.
+Note that max wait 0 means infinity.
 
-> def find_eles_by_attr_include tag, attr, value
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Float] interval - the time in seconds to wait after calling the block
 
-Get tags by attribute that include value.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] block - the block to call
 
-__Parameters:__
+__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] the result of block.call
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must include
+##### [ignore](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L49) 
 
-__Returns:__
+> def ignore &block
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag who's attribute includes value
+Return block.call and ignore any exceptions.
 
 --
 
-##### [find_ele_by_text_include](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L149) 
+##### [wait_true](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L64) 
 
-> def find_ele_by_text_include tag, text
+> def wait_true max_wait=30, interval=0.5, &block
 
-Get the first tag that includes text.
-element.attribute(:text).include? text
+Check every 0.5 seconds to see if block.call returns a truthy value.
+Note this isn't a strict boolean true, any truthy value is accepted.
+false and nil are considered failures.
+Give up after 30 seconds.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] max_wait - the maximum time in seconds to wait for
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Float] interval - the time in seconds to wait after calling the block
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text the element must include
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] block - the block to call
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag that includes text
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] the result of block.call
 
 --
 
-##### [find_eles_by_text_include](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L158) 
+##### [back](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L81) 
 
-> def find_eles_by_text_include tag, text
+> def back
 
-Get the tags that include text.
-element.attribute(:text).include? text
+Navigate back.
 
-__Parameters:__
+__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text the element must include
+--
 
-__Returns:__
+##### [session_id](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L86) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag that includes text
+> def session_id
+
+For Sauce Labs reporting. Returns the current session id.
 
 --
 
-##### [first_ele](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L165) 
+##### [xpath](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L94) 
 
-> def first_ele tag_name
+> def xpath xpath_str
 
-Get the first tag that matches tag_name
+Returns the first element that matches the provided xpath.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag to match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] xpath_str - the XPath string
 
 __Returns:__
 
@@ -943,27 +938,27 @@ __Returns:__
 
 --
 
-##### [last_ele](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L173) 
+##### [xpaths](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L102) 
 
-> def last_ele tag_name
+> def xpaths xpath_str
 
-Get the last tag that matches tag_name
+Returns all elements that match the provided xpath.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag to match
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] xpath_str - the XPath string
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
 
 --
 
-##### [source](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L179) 
+##### [source](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L108) 
 
 > def source
 
-Prints a JSON view of the current page
+Prints xml of the current page
 
 __Returns:__
 
@@ -971,83 +966,81 @@ __Returns:__
 
 --
 
-##### [get_source](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L185) 
+##### [get_source](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L118) 
 
 > def get_source
 
-Gets a JSON view of the current page
+Returns XML string for the current page
+Same as driver.page_source
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[JSON] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
 
 --
 
-##### [find_name](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L194) 
+##### [result](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L125) 
 
-> def find_name name
+> def result
 
-Returns the first element that exactly matches name
+Returns the value of attribute result
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to exactly match
+##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L127) 
 
-__Returns:__
+> def initialize
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
---
 
-##### [find_names](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L202) 
+__Returns:__
 
-> def find_names name
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[CountElements] a new instance of CountElements
 
-Returns all elements that exactly match name
+--
 
-__Parameters:__
+##### [reset](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L131) 
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to exactly match
+> def reset
 
-__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
 
 --
 
-##### [tag](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L210) 
+##### [start_element](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L136) 
 
-> def tag tag_name
+> def start_element name, attrs = []
 
-Returns the first element matching tag_name
+http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag_name to search for
+##### [formatted_result](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L140) 
+
+> def formatted_result
 
-__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [tags](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L218) 
+##### [get_page_class](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L151) 
 
-> def tags tag_name
+> def get_page_class
 
-Returns all elements matching tag_name
+Returns a string of class counts.
 
-__Parameters:__
+--
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag_name to search for
+##### [page_class](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L162) 
 
-__Returns:__
+> def page_class
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+Count all classes on screen and print to stdout.
+Useful for appium_console.
 
 --
 
-##### [px_to_window_rel](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L228) 
+##### [px_to_window_rel](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L172) 
 
 > def px_to_window_rel opts={}
 
@@ -1059,15 +1052,7 @@ px_to_window_rel x: 50, y: 150
 
 --
 
-##### [lazy_load_strings](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L238) 
-
-> def lazy_load_strings
-
-
-
---
-
-##### [xml_keys](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L245) 
+##### [xml_keys](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L189) 
 
 > def xml_keys target
 
@@ -1083,7 +1068,7 @@ __Returns:__
 
 --
 
-##### [xml_values](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L253) 
+##### [xml_values](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L197) 
 
 > def xml_values target
 
@@ -1099,7 +1084,7 @@ __Returns:__
 
 --
 
-##### [resolve_id](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L261) 
+##### [resolve_id](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L205) 
 
 > def resolve_id id
 
@@ -1115,402 +1100,502 @@ __Returns:__
 
 --
 
-##### [raise_no_element_error](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/helper.rb#L267) 
+##### [window_size](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/element/window.rb#L5) 
 
-> def raise_no_element_error
+> def window_size
 
-Used to error when finding a single element fails.
+Get the window's size
 
 --
 
-##### [value](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/patch.rb#L32) 
+##### [result](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L7) android
 
-> def value
+> def result
 
-Returns the value attribute
+TODO: Support strings.xml ids
 
-Fixes NoMethodError: undefined method `value' for Selenium::WebDriver::Element
+--
+
+##### [keys](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L7) android
+
+> def keys
+
+TODO: Support strings.xml ids
 
 --
 
-##### [name](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/patch.rb#L39) 
+##### [filter](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L9) android
 
-> def name
+> def filter
 
-Returns the name attribute
 
-Fixes NoMethodError: undefined method `name' for Selenium::WebDriver::Element
 
 --
 
-##### [location_rel](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/common/patch.rb#L51) 
+##### [filter=](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L14) android
 
-> def location_rel
+> def filter= value
 
-For use with mobile tap.
+convert to string to support symbols
+
+--
+
+##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L20) android
+
+> def initialize
 
-```ruby
-execute_script 'mobile: tap', :x => 0.0, :y => 0.98
-```
 
-https://github.com/appium/appium/wiki/Automating-mobile-gestures
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[OpenStruct] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[AndroidElements] a new instance of AndroidElements
 
 --
 
-##### [CORE](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L16) 
+##### [reset](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L25) android
 
-> CORE = [ :array, :hash, :class, :file, :dir, :bigdecimal, :rational, :struct, :openstruct, :method, :unboundmethod ]
+> def reset
 
 
 
 --
 
-##### [awesome_openstruct](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L18) 
-
-> def awesome_openstruct target
+##### [start_element](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L31) android
 
+> def start_element name, attrs = []
 
+http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
 --
 
-##### [load_appium_txt](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L27) 
+##### [get_android_inspect](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L65) android
 
-> def load_appium_txt opts
+> def get_android_inspect class_name=false
 
-Load appium.txt (toml format) into system ENV
-the basedir of this file + appium.txt is what's used
+Android only.
+Returns a string containing interesting elements.
+The text, content description, and id are returned.
+if false (default) then all classes will be inspected
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Hash] opts - file: '/path/to/appium.txt', verbose: true
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class name to filter on.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>] the require files. nil if require doesn't exist
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
 
 --
 
-##### [promote_singleton_appium_methods](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L145) 
-
-> def self.promote_singleton_appium_methods main_module
+##### [page](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L80) android
 
+> def page class_name=false
 
+Intended for use with console.
+Inspects and prints the current page.
+if false (default) then all classes will be inspected
 
---
+__Parameters:__
 
-##### [promote_appium_methods](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L175) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class name to filter on.
 
-> def self.promote_appium_methods class_array
+__Returns:__
 
-Promote appium methods to class instance methods
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
-To promote methods to all classes:
+--
 
-```ruby
-Appium.promote_appium_methods Object
-```
+##### [current_app](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L88) android
 
-__Parameters:__
+> def current_app
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Class>] class_array - An array of classes
+Lists package, activity, and adb shell am start -n value for current app.
+Works on local host only (not remote).
+noinspection RubyArgCount
 
 --
 
-##### [default_wait](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L550) 
+##### [id](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L102) android
 
-> def default_wait
+> def id id
 
-Returns the default client side wait.
-This value is independent of what the server is using
+Find by id
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] id - the id to search for
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [app_path](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [ele_index](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L116) android
 
-> def app_path
+> def ele_index class_name, index
 
-Returns the value of attribute app_path
+Find the element of type class_name at matching index.
 
---
-
-##### [app_name](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+__Parameters:__
 
-> def app_name
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class name to find
 
-Returns the value of attribute app_name
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] index - the index
 
---
+__Returns:__
 
-##### [device](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the found element of type class_name
 
-> def device
+--
 
-Returns the value of attribute device
+##### [find_ele_by_attr](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L134) android
 
---
+> def find_ele_by_attr class_name, attr, value
 
-##### [app_package](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+Find the first element exactly matching class and attribute value.
 
-> def app_package
+__Parameters:__
 
-Returns the value of attribute app_package
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class name to search for
 
---
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to inspect
 
-##### [app_activity](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the expected value of the attribute
 
-> def app_activity
+__Returns:__
 
-Returns the value of attribute app_activity
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [app_wait_activity](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [find_eles_by_attr](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L143) android
 
-> def app_wait_activity
+> def find_eles_by_attr class_name, attr, value
 
-Returns the value of attribute app_wait_activity
+Find all elements exactly matching class and attribute value.
 
---
+__Parameters:__
 
-##### [sauce_username](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class name to match
 
-> def sauce_username
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
 
-Returns the value of attribute sauce_username
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must have
 
---
+__Returns:__
 
-##### [sauce_access_key](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
 
-> def sauce_access_key
+--
 
-Returns the value of attribute sauce_access_key
+##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L157) android
 
---
+> def find_ele_by_attr_include class_name, attr, value
 
-##### [port](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+Find the first element by attribute that exactly matches value.
 
-> def port
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class name to match
 
-Returns the value of attribute port
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must include
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag who's attribute includes value
 
 --
 
-##### [debug](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L166) android
 
-> def debug
+> def find_eles_by_attr_include class_name, attr, value
 
-Returns the value of attribute debug
+Find elements by attribute that include value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must include
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag who's attribute includes value
 
 --
 
-##### [export_session](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [first_ele](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L173) android
+
+> def first_ele class_name
+
+Find the first element that matches class_name
 
-> def export_session
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the tag to match
 
-Returns the value of attribute export_session
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [device_cap](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [last_ele](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L181) android
+
+> def last_ele class_name
 
-> def device_cap
+Find the last element that matches class_name
 
-Returns the value of attribute device_cap
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the tag to match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [compress_xml](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [tag](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L189) android
+
+> def tag class_name
 
-> def compress_xml
+Find the first element of type class_name
 
-Returns the value of attribute compress_xml
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class_name to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [custom_url](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L204) 
+##### [tags](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L197) android
+
+> def tags class_name
 
-> def custom_url
+Find all elements of type class_name
 
-Returns the value of attribute custom_url
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] class_name - the class_name to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [global_webdriver_http_sleep](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L210) 
+##### [xpath_visible_contains](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L232) android
 
-> def global_webdriver_http_sleep
+> def xpath_visible_contains element, value
 
-The amount to sleep in seconds before every webdriver http call.
+Find the first element that contains value
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] element - the class name for the element
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [global_webdriver_http_sleep=](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L210) 
+##### [xpaths_visible_contains](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L240) android
 
-> def global_webdriver_http_sleep=(value)
+> def xpaths_visible_contains element, value
 
-The amount to sleep in seconds before every webdriver http call.
+Find all elements containing value
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] element - the class name for the element
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L240) 
+##### [xpath_visible_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L266) android
 
-> def initialize opts={}
+> def xpath_visible_exact element, value
 
-Creates a new driver.
-:device is :android, :ios, or :selendroid
+Find the first element exactly matching value
 
-```ruby
-# Options include:
-:app_path, :app_name, :app_package, :app_activity,
-:app_wait_activity, :sauce_username, :sauce_access_key,
-:port, :os, :debug
+__Parameters:__
 
-require 'rubygems'
-require 'appium_lib'
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] element - the class name for the element
 
-# Start iOS driver
-app = { device: :ios, app_path: '/path/to/MyiOS.app'}
-Appium::Driver.new(app).start_driver
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
-# Start Android driver
-apk = { device: :android
-        app_path: '/path/to/the.apk',
-        app_package: 'com.example.pkg',
-        app_activity: 'act.Start',
-        app_wait_activity: 'act.Start'
-}
+__Returns:__
 
-Appium::Driver.new(apk).start_driver
-```
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [xpaths_visible_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L274) android
+
+> def xpaths_visible_exact element, value
+
+Find all elements exactly matching value
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] opts - A hash containing various options.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] element - the class name for the element
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Driver] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
 
 --
 
-##### [status](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L363) 
+##### [TextView](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L4) android
 
-> def status
+> TextView = 'android.widget.TextView'
 
-Returns the status payload
 
-```ruby
-{"status"=>0,
- "value"=>
-  {"build"=>
-    {"version"=>"0.8.2",
-     "revision"=>"f2a2bc3782e4b0370d97a097d7e04913cf008995"}},
- "sessionId"=>"8f4b34a7-a9a9-4ac5-b125-36258143446a"}
-```
 
- Discover the Appium rev running on the server.
+--
+
+##### [s_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L10) android
 
-`status["value"]["build"]["revision"]`
-`f2a2bc3782e4b0370d97a097d7e04913cf008995`
+> def s_text value
+
+Find the first TextView that contains value or by index.
+If int then the TextView at that index is returned.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] value - the value to find.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[JSON] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[TextView] 
 
 --
 
-##### [server_version](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L369) 
+##### [s_texts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L18) android
+
+> def s_texts value
+
+Find all TextViews containing value.
 
-> def server_version
+__Parameters:__
 
-Returns the server's version string
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<TextView>] 
 
 --
 
-##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L412) 
+##### [first_s_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L24) android
 
-> def self.absolute_app_path app_path
+> def first_s_text
 
-Converts environment variable APP_PATH to an absolute path.
+Find the first TextView.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] APP_PATH as an absolute path
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[TextView] 
 
 --
 
-##### [server_url](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L436) 
+##### [last_s_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L30) android
 
-> def server_url
+> def last_s_text
 
-Get the server url for sauce or local based on env vars.
+Find the last TextView.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] the server url
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[TextView] 
 
 --
 
-##### [restart](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L447) 
+##### [s_text_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L37) android
 
-> def restart
+> def s_text_exact value
 
-Restarts the driver
+Find the first TextView that exactly matches value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to match exactly
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Driver] the driver
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[TextView] 
 
 --
 
-##### [driver](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L454) 
+##### [s_texts_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L44) android
 
-> def driver
+> def s_texts_exact value
 
-Returns the driver
+Find all TextViews that exactly match value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to match exactly
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Driver] the driver
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<TextView>] 
 
 --
 
-##### [screenshot](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L464) 
+##### [e_s_texts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L50) android
 
-> def screenshot png_save_path
+> def e_s_texts
 
-Takes a png screenshot and saves to the target path.
+Find all TextViews.
 
-Example: screenshot '/tmp/hi.png'
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<TextView>] 
+
+--
+
+##### [alert_click](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L6) android
+
+> def alert_click value
+
+Click the first alert button that contains value or by index.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] png_save_path - the full path to save the png
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer, String] value - either an integer index of the button or the button's name
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[nil] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
 --
 
-##### [driver_quit](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L471) 
+##### [alert_accept](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L13) android
 
-> def driver_quit
+> def alert_accept
 
-Quits the driver
+Accept the alert.
+The last button is considered "accept."
 
 __Returns:__
 
@@ -1518,163 +1603,414 @@ __Returns:__
 
 --
 
-##### [start_driver](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L479) 
+##### [alert_accept_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L20) android
 
-> def start_driver
+> def alert_accept_text
 
-Creates a new global driver and quits the old one if it exists.
+Get the text of the alert's accept button.
+The last button is considered "accept."
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Selenium::WebDriver] the new global driver
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
 
 --
 
-##### [no_wait](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L513) 
+##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L27) android
 
-> def no_wait
+> def alert_dismiss
 
-Set implicit wait and default_wait to zero.
+Dismiss the alert.
+The first button is considered "dismiss."
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
 
 --
 
-##### [set_wait](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L532) 
+##### [alert_dismiss_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L34) android
 
-> def set_wait timeout=nil
+> def alert_dismiss_text
 
-Set implicit wait and default_wait to timeout, defaults to 30.
-if set_wait is called without a param then the second to last
-wait will be used.
+Get the text of the alert's dismiss button.
+The first button is considered "dismiss."
 
-```ruby`
-set_wait 2
-set_wait 3
-set_wait # 2
+__Returns:__
 
-````
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [uiautomator_find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/mobile_methods.rb#L10) android
+
+> def 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)'
+```
+
+--
+
+##### [Button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L4) android
+
+> Button      = 'android.widget.Button'
+
+
+
+--
+
+##### [ImageButton](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L5) android
+
+> ImageButton = 'android.widget.ImageButton'
+
+
+
+--
+
+##### [button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L39) android
+
+> def button value
+
+Find the first button that contains value or by index.
+If int then the button at that index is returned.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] timeout - the timeout in seconds
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] value - the value to exactly match.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
 
 --
 
-##### [exists](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L566) 
+##### [buttons](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L55) android
 
-> def exists pre_check=0, post_check=@default_wait, &search_block
+> def buttons value
 
-Returns existence of element.
+Find all buttons containing value
 
-Example:
+__Parameters:__
 
-exists { button('sign in') } ? puts('true') : puts('false')
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
+
+--
+
+##### [first_button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L61) android
+
+> def first_button
+
+Find the first button.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+
+--
+
+##### [last_button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L67) android
+
+> def last_button
+
+Find the last button.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+
+--
+
+##### [button_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L74) android
+
+> def button_exact value
+
+Find the first button that exactly matches value.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] pre_check - the amount in seconds to set the
-wait to before checking existance
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to match exactly
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] post_check - the amount in seconds to set the
-wait to after checking existance
+__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] search_block - the block to call
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+
+--
+
+##### [buttons_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L81) android
+
+> def buttons_exact value
+
+Find all buttons that exactly match value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to match exactly
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Boolean] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
 
 --
 
-##### [execute_script](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L590) 
+##### [e_buttons](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L87) android
 
-> def execute_script script, *args
+> def e_buttons
 
-The same as @driver.execute_script
+Find all buttons.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
+
+--
+
+##### [find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L7) android
+
+> def find value
+
+Find the first element containing value
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] script - the script to execute
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to pass to the script
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [finds](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L14) android
+
+> def finds value
+
+Find all elements containing value
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
 
 --
 
-##### [mobile](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L606) 
+##### [find_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L21) android
 
-> def mobile method, *args
+> def find_exact value
 
-Helper method for mobile gestures
+Find the first element exactly matching value
 
-https://github.com/appium/appium/wiki/Automating-mobile-gestures
+__Parameters:__
 
-driver.execute_script 'mobile: swipe', endX: 100, endY: 100, duration: 0.01
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
-becomes
+__Returns:__
 
-mobile :swipe, endX: 100, endY: 100, duration: 0.01
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [finds_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L28) android
+
+> def finds_exact value
+
+Find all elements exactly matching value
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Symbol] method - the method to execute
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
+
+__Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to pass to the method
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
+
+--
+
+##### [scroll_to](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L35) android
+
+> def scroll_to text
+
+Scroll to the first element containing target text or description.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for in the text value and content description
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element scrolled to
 
 --
 
-##### [find_elements](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L617) 
+##### [scroll_to_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L48) android
 
-> def find_elements *args
+> def scroll_to_exact text
 
-Calls @driver.find_elements
+Scroll to the first element with the exact target text or description.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to use
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for in the text value and content description
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] Array is empty when no elements are found.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element scrolled to
 
 --
 
-##### [find_element](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L625) 
+##### [EditText](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L3) android
 
-> def find_element *args
+> EditText = 'android.widget.EditText'
 
-Calls @driver.find_elements
+
+
+--
+
+##### [textfield](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L9) android
+
+> def textfield value
+
+Find the first EditText that contains value or by index.
+If int then the EditText at that index is returned.
 
 __Parameters:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to use
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] value - the text to match exactly.
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[EditText] 
 
 --
 
-##### [x](https://github.com/appium/ruby_lib/blob/a07da28de1e7133c77070859c2c35d7bd2635684/lib/appium_lib/driver.rb#L632) 
+##### [textfields](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L17) android
 
-> def x
+> def textfields value
 
-Quit the driver and Pry.
-quit and exit are reserved by Pry.
+Find all EditTexts containing value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to search for
 
 __Returns:__
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<EditText>] 
+
+--
+
+##### [first_textfield](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L23) android
+
+> def first_textfield
+
+Find the first EditText.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[EditText] 
+
+--
+
+##### [last_textfield](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L29) android
+
+> def last_textfield
+
+Find the last EditText.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[EditText] 
+
+--
+
+##### [textfield_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L36) android
+
+> def textfield_exact value
+
+Find the first EditText that exactly matches value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to match exactly
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[EditText] 
+
+--
+
+##### [textfields_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L43) android
+
+> def textfields_exact value
+
+Find all EditTexts that exactly match value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value to match exactly
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<EditText>] 
+
+--
+
+##### [e_textfields](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L49) android
+
+> def e_textfields
+
+Find all EditTexts.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<EditText>] 
+
+--
+
+##### [value](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/patch.rb#L10) 
+
+> def value
+
+Returns the value attribute
+
+Fixes NoMethodError: undefined method `value' for Selenium::WebDriver::Element
+
+--
+
+##### [name](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/patch.rb#L17) 
+
+> def name
+
+Returns the name attribute
+
+Fixes NoMethodError: undefined method `name' for Selenium::WebDriver::Element
+
+--
+
+##### [location_rel](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/patch.rb#L29) 
+
+> def location_rel
+
+For use with mobile tap.
+
+```ruby
+execute_script 'mobile: tap', :x => 0.0, :y => 0.98
+```
+
+https://github.com/appium/appium/wiki/Automating-mobile-gestures
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[OpenStruct] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }
 
 --