appium_lib 4.1.0 → 5.0.0

data/docs/docs.md

@@ -17,6 +17,34 @@
 - [Appium's mobile gesture docs](https://github.com/appium/appium/wiki/Automating-mobile-gestures)
 - [MiniTest Expectations](http://docs.seattlerb.org/minitest/Minitest/Expectations.html)
 
+
+--
+
+Driver types.
+
+```ruby
+# appium specific driver with helpers available
+@appium_driver = Appium::Driver.new @options
+# standard selenium driver without any appium methods
+@selenium_driver = @appium_driver.start_driver
+```
+
+--
+
+Example of automating the built in Android settings.
+
+```ruby
+# run Pry, and paste the following
+apk = { 
+        platformName: :android,
+        deviceName: :nexus,
+        appPackage: 'com.android.settings',
+        appActivity: '.Settings',
+        appWaitActivity: '.Settings'
+      }
+Appium::Driver.new(caps: apk).start_driver
+```
+
 --
 
 Example use of Appium's mobile gesture.

data/docs/ios_docs.md

@@ -1,4 +1,4 @@
-##### [load_appium_txt](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L72) 
+##### [load_appium_txt](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L72) 
 
 > def self.load_appium_txt opts={}
 
@@ -27,7 +27,7 @@ __Returns:__
 
 --
 
-##### [symbolize_keys](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L142) 
+##### [symbolize_keys](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L142) 
 
 > def self.symbolize_keys hash
 
@@ -38,7 +38,7 @@ https://github.com/rails/docrails/blob/a3b1105ada3da64acfa3843b164b14b734456a50/
 
 --
 
-##### [promote_singleton_appium_methods](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L155) 
+##### [promote_singleton_appium_methods](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L155) 
 
 > def self.promote_singleton_appium_methods modules
 
@@ -48,7 +48,7 @@ otherwise, the array of modules will be used as the promotion target.
 
 --
 
-##### [promote_appium_methods](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L195) 
+##### [promote_appium_methods](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L195) 
 
 > def self.promote_appium_methods class_array
 
@@ -66,7 +66,7 @@ __Parameters:__
 
 --
 
-##### [global_webdriver_http_sleep](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [global_webdriver_http_sleep](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L231) 
 
 > def global_webdriver_http_sleep
 
@@ -74,7 +74,7 @@ The amount to sleep in seconds before every webdriver http call.
 
 --
 
-##### [global_webdriver_http_sleep=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [global_webdriver_http_sleep=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L231) 
 
 > def global_webdriver_http_sleep=(value)
 
@@ -82,55 +82,55 @@ The amount to sleep in seconds before every webdriver http call.
 
 --
 
-##### [caps](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [caps](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L233) 
 
 > def caps
 
-The amount to sleep in seconds before every webdriver http call.
+Selenium webdriver capabilities
 
 --
 
-##### [caps=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [caps=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L233) 
 
 > def caps=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Selenium webdriver capabilities
 
 --
 
-##### [custom_url](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [custom_url](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L235) 
 
 > def custom_url
 
-The amount to sleep in seconds before every webdriver http call.
+Custom URL for the selenium server
 
 --
 
-##### [custom_url=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [custom_url=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L235) 
 
 > def custom_url=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Custom URL for the selenium server
 
 --
 
-##### [export_session](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [export_session](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L237) 
 
 > def export_session
 
-The amount to sleep in seconds before every webdriver http call.
+Export session id to textfile in /tmp for 3rd party tools
 
 --
 
-##### [export_session=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [export_session=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L237) 
 
 > def export_session=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Export session id to textfile in /tmp for 3rd party tools
 
 --
 
-##### [default_wait](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [default_wait](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L239) 
 
 > def default_wait
 
@@ -143,111 +143,111 @@ __Returns:__
 
 --
 
-##### [default_wait=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [default_wait=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L239) 
 
 > def default_wait=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Default wait time for elements to appear
 
 --
 
-##### [last_waits](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [last_waits](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L241) 
 
 > def last_waits
 
-The amount to sleep in seconds before every webdriver http call.
+Array of previous wait time values
 
 --
 
-##### [last_waits=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [last_waits=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L241) 
 
 > def last_waits=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Array of previous wait time values
 
 --
 
-##### [sauce_username](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [sauce_username](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L243) 
 
 > def sauce_username
 
-The amount to sleep in seconds before every webdriver http call.
+Username for use on Sauce Labs
 
 --
 
-##### [sauce_username=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [sauce_username=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L243) 
 
 > def sauce_username=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Username for use on Sauce Labs
 
 --
 
-##### [sauce_access_key](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [sauce_access_key](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L245) 
 
 > def sauce_access_key
 
-The amount to sleep in seconds before every webdriver http call.
+Access Key for use on Sauce Labs
 
 --
 
-##### [sauce_access_key=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [sauce_access_key=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L245) 
 
 > def sauce_access_key=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Access Key for use on Sauce Labs
 
 --
 
-##### [appium_port](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [appium_port](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L247) 
 
 > def appium_port
 
-The amount to sleep in seconds before every webdriver http call.
+Appium's server port
 
 --
 
-##### [appium_port=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [appium_port=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L247) 
 
 > def appium_port=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Appium's server port
 
 --
 
-##### [appium_device](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [appium_device](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L249) 
 
 > def appium_device
 
-The amount to sleep in seconds before every webdriver http call.
+Device type to request from the appium server
 
 --
 
-##### [appium_device=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [appium_device=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L249) 
 
 > def appium_device=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Device type to request from the appium server
 
 --
 
-##### [appium_debug](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [appium_debug](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L251) 
 
 > def appium_debug
 
-The amount to sleep in seconds before every webdriver http call.
+Boolean debug mode for the Appium Ruby bindings
 
 --
 
-##### [appium_debug=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L228) 
+##### [appium_debug=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L251) 
 
 > def appium_debug=(value)
 
-The amount to sleep in seconds before every webdriver http call.
+Boolean debug mode for the Appium Ruby bindings
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L259) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L272) 
 
 > def initialize opts={}
 
@@ -278,7 +278,7 @@ __Returns:__
 
 --
 
-##### [driver_attributes](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L334) 
+##### [driver_attributes](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L347) 
 
 > def driver_attributes
 
@@ -286,7 +286,7 @@ Returns a hash of the driver attributes
 
 --
 
-##### [device_is_android?](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L354) 
+##### [device_is_android?](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L367) 
 
 > def device_is_android?
 
@@ -298,7 +298,7 @@ __Returns:__
 
 --
 
-##### [appium_server_version](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L370) 
+##### [appium_server_version](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L383) 
 
 > def appium_server_version
 
@@ -319,7 +319,7 @@ __Returns:__
 
 --
 
-##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L382) 
+##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L395) 
 
 > def self.absolute_app_path opts
 
@@ -336,7 +336,7 @@ __Returns:__
 
 --
 
-##### [server_url](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L415) 
+##### [server_url](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L428) 
 
 > def server_url
 
@@ -348,7 +348,7 @@ __Returns:__
 
 --
 
-##### [restart](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L426) 
+##### [restart](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L439) 
 
 > def restart
 
@@ -360,7 +360,7 @@ __Returns:__
 
 --
 
-##### [driver](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L433) 
+##### [driver](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L446) 
 
 > def driver
 
@@ -372,7 +372,7 @@ __Returns:__
 
 --
 
-##### [screenshot](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L443) 
+##### [screenshot](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L456) 
 
 > def screenshot png_save_path
 
@@ -390,7 +390,7 @@ __Returns:__
 
 --
 
-##### [driver_quit](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L450) 
+##### [driver_quit](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L463) 
 
 > def driver_quit
 
@@ -402,7 +402,7 @@ __Returns:__
 
 --
 
-##### [start_driver](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L458) 
+##### [start_driver](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L471) 
 
 > def start_driver
 
@@ -414,7 +414,7 @@ __Returns:__
 
 --
 
-##### [no_wait](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L485) 
+##### [no_wait](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L497) 
 
 > def no_wait
 
@@ -422,7 +422,7 @@ Set implicit wait and default_wait to zero.
 
 --
 
-##### [set_wait](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L504) 
+##### [set_wait](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L516) 
 
 > def set_wait timeout=nil
 
@@ -447,7 +447,7 @@ __Returns:__
 
 --
 
-##### [exists](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L538) 
+##### [exists](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L550) 
 
 > def exists pre_check=0, post_check=@default_wait, &search_block
 
@@ -473,7 +473,7 @@ __Returns:__
 
 --
 
-##### [execute_script](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L562) 
+##### [execute_script](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L574) 
 
 > def execute_script script, *args
 
@@ -491,7 +491,7 @@ __Returns:__
 
 --
 
-##### [find_elements](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L570) 
+##### [find_elements](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L582) 
 
 > def find_elements *args
 
@@ -507,7 +507,7 @@ __Returns:__
 
 --
 
-##### [find_element](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L578) 
+##### [find_element](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L590) 
 
 > def find_element *args
 
@@ -523,7 +523,7 @@ __Returns:__
 
 --
 
-##### [x](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/driver.rb#L585) 
+##### [x](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/driver.rb#L597) 
 
 > def x
 
@@ -536,7 +536,7 @@ __Returns:__
 
 --
 
-##### [NoArgMethods](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L7) 
+##### [NoArgMethods](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L7) 
 
 > NoArgMethods = {
 
@@ -544,7 +544,7 @@ __Returns:__
 
 --
 
-##### [app_strings](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L22) 
+##### [app_strings](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L23) 
 
 > def app_strings
 
@@ -555,7 +555,7 @@ app_strings #=> "TransitionsTitle"=>"Transitions", "WebTitle"=>"Web"
 
 --
 
-##### [background_app](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L28) 
+##### [background_app](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L29) 
 
 > def background_app
 
@@ -564,7 +564,7 @@ This is a blocking application
 
 --
 
-##### [current_activity](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L33) 
+##### [current_activity](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L34) 
 
 > def current_activity
 
@@ -572,15 +572,15 @@ This is a blocking application
 
 --
 
-##### [launch](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L35) 
+##### [launch_app](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L36) 
 
-> def launch
+> def launch_app
 
 Start the simulator and applicaton configured with desired capabilities
 
 --
 
-##### [reset](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L38) 
+##### [reset](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L39) 
 
 > def reset
 
@@ -588,7 +588,7 @@ Reset the device, relaunching the application.
 
 --
 
-##### [shake](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L41) 
+##### [shake](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L42) 
 
 > def shake
 
@@ -596,7 +596,7 @@ Cause the device to shake
 
 --
 
-##### [toggle_flight_mode](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L44) 
+##### [toggle_flight_mode](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L45) 
 
 > def toggle_flight_mode
 
@@ -604,7 +604,7 @@ toggle flight mode on or off
 
 --
 
-##### [hide_keyboard](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L47) 
+##### [hide_keyboard](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L48) 
 
 > def hide_keyboard
 
@@ -617,7 +617,7 @@ Defaults to 'Done'.
 
 --
 
-##### [press_keycode](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L56) 
+##### [press_keycode](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L57) 
 
 > def press_keycode
 
@@ -632,7 +632,7 @@ __Parameters:__
 
 --
 
-##### [long_press_keycode](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L62) 
+##### [long_press_keycode](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L63) 
 
 > def long_press_keycode
 
@@ -647,7 +647,7 @@ __Parameters:__
 
 --
 
-##### [push_file](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L68) 
+##### [push_file](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L69) 
 
 > def push_file
 
@@ -661,7 +661,7 @@ __Parameters:__
 
 --
 
-##### [pull_file](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L73) 
+##### [pull_file](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L74) 
 
 > def pull_file
 
@@ -678,7 +678,7 @@ __Parameters:__
 
 --
 
-##### [pull_folder](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L83) 
+##### [pull_folder](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L84) 
 
 > def pull_folder
 
@@ -693,7 +693,29 @@ __Parameters:__
 
 --
 
-##### [extend_search_contexts](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L274) 
+##### [end_coverage](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L92) 
+
+> def end_coverage
+
+Android only;  Ends the test coverage and writes the results to the given path on device.
+
+__Parameters:__
+
+     [String] path - Path on the device to write too.
+
+     [String] intent - Intent to broadcast when ending coverage.
+
+--
+
+##### [get_settings](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L97) 
+
+> def get_settings
+
+Get appium Settings for current test session
+
+--
+
+##### [extend_search_contexts](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L345) 
 
 > def extend_search_contexts
 
@@ -701,7 +723,7 @@ __Parameters:__
 
 --
 
-##### [accessiblity_id_find](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L274) 
+##### [accessiblity_id_find](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L345) 
 
 > def accessiblity_id_find
 
@@ -713,7 +735,7 @@ find_element/s with their accessibility_id
 
 --
 
-##### [add_touch_actions](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L280) 
+##### [add_touch_actions](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L351) 
 
 > def add_touch_actions
 
@@ -721,7 +743,7 @@ find_element/s with their accessibility_id
 
 --
 
-##### [set_context](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L304) 
+##### [set_context](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L375) 
 
 > def set_context
 
@@ -736,7 +758,7 @@ __Parameters:__
 
 --
 
-##### [current_context](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L312) 
+##### [current_context](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L383) 
 
 > def current_context
 
@@ -748,7 +770,7 @@ __Returns:__
 
 --
 
-##### [available_contexts](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L315) 
+##### [available_contexts](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L386) 
 
 > def available_contexts
 
@@ -760,7 +782,7 @@ __Returns:__
 
 --
 
-##### [within_context](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L325) 
+##### [within_context](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L396) 
 
 > def within_context(context)
 
@@ -776,7 +798,7 @@ __Parameters:__
 
 --
 
-##### [switch_to_default_context](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/device.rb#L333) 
+##### [switch_to_default_context](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/device.rb#L404) 
 
 > def switch_to_default_context
 
@@ -784,7 +806,7 @@ Change to the default context.  This is equivalent to `set_context nil`.
 
 --
 
-##### [pinch](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/multi_touch.rb#L30) 
+##### [pinch](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/multi_touch.rb#L30) 
 
 > def pinch(percentage=25, auto_perform=true)
 
@@ -803,7 +825,7 @@ __Parameters:__
 
 --
 
-##### [zoom](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/multi_touch.rb#L58) 
+##### [zoom](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/multi_touch.rb#L58) 
 
 > def zoom(percentage=200, auto_perform=true)
 
@@ -822,7 +844,7 @@ __Parameters:__
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/multi_touch.rb#L79) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/multi_touch.rb#L79) 
 
 > def initialize
 
@@ -834,7 +856,7 @@ __Returns:__
 
 --
 
-##### [add](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/multi_touch.rb#L85) 
+##### [add](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/multi_touch.rb#L85) 
 
 > def add(chain)
 
@@ -846,7 +868,7 @@ __Parameters:__
 
 --
 
-##### [perform](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/multi_touch.rb#L90) 
+##### [perform](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/multi_touch.rb#L90) 
 
 > def perform
 
@@ -854,7 +876,7 @@ Ask Appium to perform the actions
 
 --
 
-##### [ACTIONS](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L12) 
+##### [ACTIONS](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L12) 
 
 > ACTIONS         = [:move_to, :long_press, :press, :release, :tap, :wait, :perform]
 
@@ -862,7 +884,7 @@ Ask Appium to perform the actions
 
 --
 
-##### [COMPLEX_ACTIONS](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L13) 
+##### [COMPLEX_ACTIONS](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L13) 
 
 > COMPLEX_ACTIONS = [:swipe]
 
@@ -870,7 +892,7 @@ Ask Appium to perform the actions
 
 --
 
-##### [actions](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L27) 
+##### [actions](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L27) 
 
 > def actions
 
@@ -878,7 +900,7 @@ Returns the value of attribute actions
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L29) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L29) 
 
 > def initialize
 
@@ -890,7 +912,7 @@ __Returns:__
 
 --
 
-##### [move_to](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L37) 
+##### [move_to](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L37) 
 
 > def move_to(opts)
 
@@ -902,7 +924,7 @@ __Parameters:__
 
 --
 
-##### [long_press](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L47) 
+##### [long_press](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L47) 
 
 > def long_press(opts)
 
@@ -920,7 +942,7 @@ __Parameters:__
 
 --
 
-##### [press](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L59) 
+##### [press](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L59) 
 
 > def press(opts)
 
@@ -933,7 +955,7 @@ __Parameters:__
 
 --
 
-##### [release](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L70) 
+##### [release](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L70) 
 
 > def release(opts=nil)
 
@@ -945,7 +967,7 @@ __Parameters:__
 
 --
 
-##### [tap](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L81) 
+##### [tap](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L81) 
 
 > def tap(opts)
 
@@ -957,7 +979,7 @@ __Parameters:__
 
 --
 
-##### [wait](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L90) 
+##### [wait](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L90) 
 
 > def wait(milliseconds)
 
@@ -969,7 +991,7 @@ __Parameters:__
 
 --
 
-##### [swipe](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L104) 
+##### [swipe](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L104) 
 
 > def swipe(opts)
 
@@ -983,7 +1005,7 @@ __Parameters:__
 
 --
 
-##### [perform](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L119) 
+##### [perform](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L119) 
 
 > def perform
 
@@ -991,7 +1013,7 @@ Ask the driver to perform all actions in this action chain.
 
 --
 
-##### [cancel](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L125) 
+##### [cancel](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L125) 
 
 > def cancel
 
@@ -999,7 +1021,7 @@ Does nothing, currently.
 
 --
 
-##### [chain_method](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L133) 
+##### [chain_method](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L133) 
 
 > def chain_method(method, args=nil)
 
@@ -1007,7 +1029,7 @@ Does nothing, currently.
 
 --
 
-##### [args_with_ele_ref](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/device/touch_actions.rb#L142) 
+##### [args_with_ele_ref](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/device/touch_actions.rb#L142) 
 
 > def args_with_ele_ref(args)
 
@@ -1015,7 +1037,7 @@ Does nothing, currently.
 
 --
 
-##### [_generic_wait](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/wait.rb#L10) 
+##### [_generic_wait](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/wait.rb#L10) 
 
 > def _generic_wait opts={}, &block
 
@@ -1024,7 +1046,7 @@ https://github.com/SeleniumHQ/selenium/blob/cf501dda3f0ed12233de51ce8170c0e8090f
 
 --
 
-##### [_process_wait_opts](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/wait.rb#L55) 
+##### [_process_wait_opts](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/wait.rb#L55) 
 
 > def _process_wait_opts opts
 
@@ -1032,7 +1054,7 @@ process opts before calling _generic_wait
 
 --
 
-##### [wait_true](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/wait.rb#L76) 
+##### [wait_true](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/wait.rb#L76) 
 
 > def wait_true opts={}, &block
 
@@ -1052,7 +1074,7 @@ __Parameters:__
 
 --
 
-##### [wait](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/wait.rb#L94) 
+##### [wait](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/wait.rb#L94) 
 
 > def wait opts={}, &block
 
@@ -1070,7 +1092,7 @@ __Parameters:__
 
 --
 
-##### [ignore](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L22) 
+##### [ignore](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L24) 
 
 > def ignore &block
 
@@ -1078,7 +1100,7 @@ Return block.call and ignore any exceptions.
 
 --
 
-##### [back](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L31) 
+##### [back](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L33) 
 
 > def back
 
@@ -1090,7 +1112,7 @@ __Returns:__
 
 --
 
-##### [session_id](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L36) 
+##### [session_id](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L38) 
 
 > def session_id
 
@@ -1098,7 +1120,7 @@ For Sauce Labs reporting. Returns the current session id.
 
 --
 
-##### [xpath](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L44) 
+##### [xpath](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L46) 
 
 > def xpath xpath_str
 
@@ -1114,7 +1136,7 @@ __Returns:__
 
 --
 
-##### [xpaths](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L52) 
+##### [xpaths](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L54) 
 
 > def xpaths xpath_str
 
@@ -1130,32 +1152,15 @@ __Returns:__
 
 --
 
-##### [source](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L58) 
+##### [_print_source](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L58) 
 
-> def source
+> def _print_source source
 
-Prints xml of the current page
 
-__Returns:__
-
-     [void] 
 
 --
 
-##### [get_source](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L76) 
-
-> def get_source
-
-Returns XML string for the current page
-Same as driver.page_source
-
-__Returns:__
-
-     [String] 
-
---
-
-##### [result](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L83) 
+##### [result](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L71) 
 
 > def result
 
@@ -1163,7 +1168,7 @@ Returns the value of attribute result
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L85) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L73) 
 
 > def initialize
 
@@ -1175,7 +1180,7 @@ __Returns:__
 
 --
 
-##### [reset](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L89) 
+##### [reset](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L77) 
 
 > def reset
 
@@ -1183,7 +1188,7 @@ __Returns:__
 
 --
 
-##### [start_element](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L94) 
+##### [start_element](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L82) 
 
 > def start_element name, attrs = []
 
@@ -1191,7 +1196,7 @@ http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
 --
 
-##### [formatted_result](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L100) 
+##### [formatted_result](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L88) 
 
 > def formatted_result
 
@@ -1199,7 +1204,7 @@ http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
 --
 
-##### [get_page_class](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L111) 
+##### [get_page_class](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L99) 
 
 > def get_page_class
 
@@ -1207,7 +1212,7 @@ Returns a string of class counts of visible elements.
 
 --
 
-##### [page_class](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L122) 
+##### [page_class](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L110) 
 
 > def page_class
 
@@ -1216,7 +1221,7 @@ Useful for appium_console.
 
 --
 
-##### [px_to_window_rel](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L132) 
+##### [px_to_window_rel](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L120) 
 
 > def px_to_window_rel opts={}
 
@@ -1228,7 +1233,7 @@ px_to_window_rel x: 50, y: 150
 
 --
 
-##### [xml_keys](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L149) 
+##### [xml_keys](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L139) 
 
 > def xml_keys target
 
@@ -1244,7 +1249,7 @@ __Returns:__
 
 --
 
-##### [xml_values](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L157) 
+##### [xml_values](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L147) 
 
 > def xml_values target
 
@@ -1260,7 +1265,7 @@ __Returns:__
 
 --
 
-##### [resolve_id](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L165) 
+##### [resolve_id](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L155) 
 
 > def resolve_id id
 
@@ -1276,7 +1281,7 @@ __Returns:__
 
 --
 
-##### [filter](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L171) 
+##### [filter](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L161) 
 
 > def filter
 
@@ -1284,7 +1289,7 @@ __Returns:__
 
 --
 
-##### [filter=](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L176) 
+##### [filter=](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L166) 
 
 > def filter= value
 
@@ -1292,7 +1297,7 @@ convert to string to support symbols
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L182) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L172) 
 
 > def initialize
 
@@ -1304,7 +1309,7 @@ __Returns:__
 
 --
 
-##### [reset](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L187) 
+##### [reset](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L177) 
 
 > def reset
 
@@ -1312,7 +1317,7 @@ __Returns:__
 
 --
 
-##### [result](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L193) 
+##### [result](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L183) 
 
 > def result
 
@@ -1320,7 +1325,7 @@ __Returns:__
 
 --
 
-##### [start_element](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L207) 
+##### [start_element](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L199) 
 
 > def start_element name, attrs = []
 
@@ -1328,7 +1333,7 @@ __Returns:__
 
 --
 
-##### [end_element](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L217) 
+##### [end_element](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L209) 
 
 > def end_element name
 
@@ -1336,7 +1341,7 @@ __Returns:__
 
 --
 
-##### [characters](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/helper.rb#L223) 
+##### [characters](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L215) 
 
 > def characters(chars)
 
@@ -1344,7 +1349,15 @@ __Returns:__
 
 --
 
-##### [window_size](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/element/window.rb#L5) 
+##### [_no_such_element](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/helper.rb#L223) 
+
+> def _no_such_element
+
+
+
+--
+
+##### [window_size](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/element/window.rb#L5) 
 
 > def window_size
 
@@ -1352,7 +1365,7 @@ Get the window's size
 
 --
 
-##### [ios_password](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L8) ios
+##### [ios_password](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L8) ios
 
 > def ios_password length=1
 
@@ -1370,7 +1383,7 @@ __Returns:__
 
 --
 
-##### [get_page](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L20) ios
+##### [get_page](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L20) ios
 
 > def get_page element=source_window(0), class_name=nil
 
@@ -1391,7 +1404,7 @@ __Returns:__
 
 --
 
-##### [page](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L125) ios
+##### [page](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L125) ios
 
 > def page opts={}
 
@@ -1417,7 +1430,7 @@ __Returns:__
 
 --
 
-##### [source_window](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L157) ios
+##### [source_window](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L157) ios
 
 > def source_window window_number=0
 
@@ -1433,7 +1446,7 @@ __Returns:__
 
 --
 
-##### [page_window](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L171) ios
+##### [page_window](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L171) ios
 
 > def page_window window_number=0
 
@@ -1451,7 +1464,7 @@ __Returns:__
 
 --
 
-##### [id](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L179) ios
+##### [id](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L179) ios
 
 > def id id
 
@@ -1467,7 +1480,7 @@ __Returns:__
 
 --
 
-##### [ios_version](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L189) ios
+##### [ios_version](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L185) ios
 
 > def ios_version
 
@@ -1479,7 +1492,7 @@ __Returns:__
 
 --
 
-##### [ele_index](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L198) ios
+##### [ele_index](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L194) ios
 
 > def ele_index class_name, index
 
@@ -1497,11 +1510,12 @@ __Returns:__
 
 --
 
-##### [find_ele_by_attr](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L216) ios
+##### [find_ele_by_attr](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L221) ios
 
 > def find_ele_by_attr class_name, attr, value
 
 Find the first element exactly matching class and attribute value.
+Note: Uses XPath
 
 __Parameters:__
 
@@ -1517,11 +1531,12 @@ __Returns:__
 
 --
 
-##### [find_eles_by_attr](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L225) ios
+##### [find_eles_by_attr](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L231) ios
 
 > def find_eles_by_attr class_name, attr, value
 
 Find all elements exactly matching class and attribute value.
+Note: Uses XPath
 
 __Parameters:__
 
@@ -1537,11 +1552,12 @@ __Returns:__
 
 --
 
-##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L239) ios
+##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L246) ios
 
 > def find_ele_by_attr_include class_name, attr, value
 
 Get the first tag by attribute that exactly matches value.
+Note: Uses XPath
 
 __Parameters:__
 
@@ -1557,11 +1573,12 @@ __Returns:__
 
 --
 
-##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L248) ios
+##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L256) ios
 
 > def find_eles_by_attr_include class_name, attr, value
 
 Get tags by attribute that include value.
+Note: Uses XPath
 
 __Parameters:__
 
@@ -1577,7 +1594,7 @@ __Returns:__
 
 --
 
-##### [first_ele](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L255) ios
+##### [first_ele](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L263) ios
 
 > def first_ele class_name
 
@@ -1593,7 +1610,7 @@ __Returns:__
 
 --
 
-##### [last_ele](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L263) ios
+##### [last_ele](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L271) ios
 
 > def last_ele class_name
 
@@ -1609,11 +1626,11 @@ __Returns:__
 
 --
 
-##### [tag](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L271) ios
+##### [tag](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L279) ios
 
 > def tag class_name
 
-Returns the first element matching class_name
+Returns the first visible element matching class_name
 
 __Parameters:__
 
@@ -1625,11 +1642,11 @@ __Returns:__
 
 --
 
-##### [tags](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L279) ios
+##### [tags](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L290) ios
 
 > def tags class_name
 
-Returns all elements matching class_name
+Returns all visible elements matching class_name
 
 __Parameters:__
 
@@ -1641,9 +1658,9 @@ __Returns:__
 
 --
 
-##### [xpath_visible_contains](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L311) ios
+##### [ele_by_json_visible_contains](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L325) ios
 
-> def xpath_visible_contains element, value
+> def ele_by_json_visible_contains element, value
 
 Find the first element that contains value
 
@@ -1659,9 +1676,9 @@ __Returns:__
 
 --
 
-##### [xpaths_visible_contains](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L319) ios
+##### [eles_by_json_visible_contains](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L333) ios
 
-> def xpaths_visible_contains element, value
+> def eles_by_json_visible_contains element, value
 
 Find all elements containing value
 
@@ -1677,9 +1694,9 @@ __Returns:__
 
 --
 
-##### [xpath_visible_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L346) ios
+##### [ele_by_json_visible_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L362) ios
 
-> def xpath_visible_exact element, value
+> def ele_by_json_visible_exact element, value
 
 Find the first element exactly matching value
 
@@ -1695,9 +1712,9 @@ __Returns:__
 
 --
 
-##### [xpaths_visible_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/helper.rb#L354) ios
+##### [eles_by_json_visible_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L370) ios
 
-> def xpaths_visible_exact element, value
+> def eles_by_json_visible_exact element, value
 
 Find all elements exactly matching value
 
@@ -1713,7 +1730,142 @@ __Returns:__
 
 --
 
-##### [UIAStaticText](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L4) ios
+##### [_all_pred](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L434) ios
+
+> def _all_pred opts
+
+predicate - the predicate to evaluate on the main app
+
+visible - if true, only visible elements are returned. default true
+
+--
+
+##### [ele_with_pred](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L447) ios
+
+> def ele_with_pred opts
+
+returns element matching predicate contained in the main app
+
+predicate - the predicate to evaluate on the main app
+
+visible - if true, only visible elements are returned. default true
+
+__Returns:__
+
+     [Element] 
+
+--
+
+##### [eles_with_pred](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L458) ios
+
+> def eles_with_pred opts
+
+returns elements matching predicate contained in the main app
+
+predicate - the predicate to evaluate on the main app
+
+visible - if true, only visible elements are returned. default true
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
+
+--
+
+##### [source](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L464) ios
+
+> def source
+
+Prints xml of the current page
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [_validate_object](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L468) ios
+
+> def _validate_object *objects
+
+
+
+--
+
+##### [_by_json](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L516) ios
+
+> def _by_json opts
+
+typeArray - array of string types to search for. Example: ["UIAStaticText"]
+onlyFirst - boolean. returns only the first result if true. Example: true
+onlyVisible - boolean. returns only visible elements if true. Example: true
+target - string. the target value to search for. Example: "Buttons, Various uses of UIButton"
+substring - boolean. matches on substrings if true otherwise an exact mathc is required. Example: true
+insensitive - boolean. ignores case sensitivity if true otherwise it's case sensitive. Example: true
+
+opts = {
+  typeArray: ["UIAStaticText"],
+  onlyFirst: true,
+  onlyVisible: true,
+  name: {
+    target: "Buttons, Various uses of UIButton",
+    substring: false,
+    insensitive: false,
+  },
+  label: {
+    target: "Buttons, Various uses of UIButton",
+    substring: false,
+    insensitive: false,
+  },
+  value: {
+    target: "Buttons, Various uses of UIButton",
+    substring: false,
+    insensitive: false,
+  }
+}
+
+--
+
+##### [eles_by_json](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L556) ios
+
+> def eles_by_json opts
+
+example usage:
+
+eles_by_json({
+  typeArray: ["UIAStaticText"],
+  onlyVisible: true,
+  name: {
+    target: "Buttons, Various uses of UIButton",
+    substring: false,
+    insensitive: false,
+  },
+})
+
+--
+
+##### [ele_by_json](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L562) ios
+
+> def ele_by_json opts
+
+see eles_by_json
+
+--
+
+##### [get_source](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/helper.rb#L572) ios
+
+> def get_source
+
+Returns XML string for the current page
+Same as driver.page_source
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [UIAStaticText](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L4) ios
 
 > UIAStaticText = 'UIAStaticText'
 
@@ -1721,7 +1873,7 @@ __Returns:__
 
 --
 
-##### [text](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L10) ios
+##### [text](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L10) ios
 
 > def text value
 
@@ -1738,7 +1890,7 @@ __Returns:__
 
 --
 
-##### [texts](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L19) ios
+##### [texts](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L19) ios
 
 > def texts value=false
 
@@ -1755,7 +1907,7 @@ __Returns:__
 
 --
 
-##### [first_text](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L26) ios
+##### [first_text](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L26) ios
 
 > def first_text
 
@@ -1767,7 +1919,7 @@ __Returns:__
 
 --
 
-##### [last_text](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L32) ios
+##### [last_text](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L32) ios
 
 > def last_text
 
@@ -1779,7 +1931,7 @@ __Returns:__
 
 --
 
-##### [text_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L39) ios
+##### [text_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L39) ios
 
 > def text_exact value
 
@@ -1795,7 +1947,7 @@ __Returns:__
 
 --
 
-##### [texts_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/text.rb#L46) ios
+##### [texts_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/text.rb#L46) ios
 
 > def texts_exact value
 
@@ -1811,7 +1963,7 @@ __Returns:__
 
 --
 
-##### [alert_accept](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/alert.rb#L5) ios
+##### [alert_accept](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/alert.rb#L5) ios
 
 > def alert_accept
 
@@ -1823,7 +1975,7 @@ __Returns:__
 
 --
 
-##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/alert.rb#L13) ios
+##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/alert.rb#L13) ios
 
 > def alert_dismiss
 
@@ -1835,7 +1987,7 @@ __Returns:__
 
 --
 
-##### [uiautomation_find](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/mobile_methods.rb#L10) ios
+##### [uiautomation_find](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/mobile_methods.rb#L10) ios
 
 > def uiautomation_find
 
@@ -1847,7 +1999,7 @@ find_element/s can be used with a [UIAutomation command](https://developer.apple
 
 --
 
-##### [UIAButton](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L4) ios
+##### [UIAButton](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L4) ios
 
 > UIAButton = 'UIAButton'
 
@@ -1855,7 +2007,7 @@ find_element/s can be used with a [UIAutomation command](https://developer.apple
 
 --
 
-##### [button](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L10) ios
+##### [button](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L10) ios
 
 > def button value
 
@@ -1872,7 +2024,7 @@ __Returns:__
 
 --
 
-##### [buttons](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L20) ios
+##### [buttons](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L20) ios
 
 > def buttons value=false
 
@@ -1889,7 +2041,7 @@ __Returns:__
 
 --
 
-##### [first_button](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L27) ios
+##### [first_button](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L27) ios
 
 > def first_button
 
@@ -1901,7 +2053,7 @@ __Returns:__
 
 --
 
-##### [last_button](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L33) ios
+##### [last_button](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L33) ios
 
 > def last_button
 
@@ -1913,7 +2065,7 @@ __Returns:__
 
 --
 
-##### [button_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L40) ios
+##### [button_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L40) ios
 
 > def button_exact value
 
@@ -1929,7 +2081,7 @@ __Returns:__
 
 --
 
-##### [buttons_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/button.rb#L47) ios
+##### [buttons_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/button.rb#L47) ios
 
 > def buttons_exact value
 
@@ -1945,7 +2097,7 @@ __Returns:__
 
 --
 
-##### [find](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/generic.rb#L7) ios
+##### [find](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/generic.rb#L7) ios
 
 > def find value
 
@@ -1961,7 +2113,7 @@ __Returns:__
 
 --
 
-##### [finds](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/generic.rb#L14) ios
+##### [finds](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/generic.rb#L14) ios
 
 > def finds value
 
@@ -1977,7 +2129,7 @@ __Returns:__
 
 --
 
-##### [find_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/generic.rb#L21) ios
+##### [find_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/generic.rb#L21) ios
 
 > def find_exact value
 
@@ -1993,7 +2145,7 @@ __Returns:__
 
 --
 
-##### [finds_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/generic.rb#L28) ios
+##### [finds_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/generic.rb#L28) ios
 
 > def finds_exact value
 
@@ -2009,7 +2161,7 @@ __Returns:__
 
 --
 
-##### [UIATextField](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L3) ios
+##### [UIATextField](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L3) ios
 
 > UIATextField       = 'UIATextField'
 
@@ -2017,7 +2169,7 @@ __Returns:__
 
 --
 
-##### [UIASecureTextField](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L4) ios
+##### [UIASecureTextField](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L4) ios
 
 > UIASecureTextField = 'UIASecureTextField'
 
@@ -2025,7 +2177,7 @@ __Returns:__
 
 --
 
-##### [textfield](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L38) ios
+##### [textfield](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L52) ios
 
 > def textfield value
 
@@ -2042,7 +2194,7 @@ __Returns:__
 
 --
 
-##### [textfields](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L55) ios
+##### [textfields](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L72) ios
 
 > def textfields value=false
 
@@ -2059,7 +2211,7 @@ __Returns:__
 
 --
 
-##### [first_textfield](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L62) ios
+##### [first_textfield](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L79) ios
 
 > def first_textfield
 
@@ -2071,7 +2223,7 @@ __Returns:__
 
 --
 
-##### [last_textfield](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L68) ios
+##### [last_textfield](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L85) ios
 
 > def last_textfield
 
@@ -2083,7 +2235,7 @@ __Returns:__
 
 --
 
-##### [textfield_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L75) ios
+##### [textfield_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L94) ios
 
 > def textfield_exact value
 
@@ -2099,7 +2251,7 @@ __Returns:__
 
 --
 
-##### [textfields_exact](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/ios/element/textfield.rb#L82) ios
+##### [textfields_exact](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/ios/element/textfield.rb#L101) ios
 
 > def textfields_exact value
 
@@ -2115,7 +2267,7 @@ __Returns:__
 
 --
 
-##### [value](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/patch.rb#L10) 
+##### [value](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/patch.rb#L12) 
 
 > def value
 
@@ -2125,7 +2277,7 @@ Fixes NoMethodError: undefined method `value' for Selenium::WebDriver::Element
 
 --
 
-##### [name](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/patch.rb#L17) 
+##### [name](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/patch.rb#L19) 
 
 > def name
 
@@ -2135,7 +2287,7 @@ Fixes NoMethodError: undefined method `name' for Selenium::WebDriver::Element
 
 --
 
-##### [location_rel](https://github.com/appium/ruby_lib/blob/a13158fb926212d84f26120c3bc5355c8cd34baf/lib/appium_lib/common/patch.rb#L29) 
+##### [location_rel](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/patch.rb#L31) 
 
 > def location_rel
 
@@ -2153,3 +2305,11 @@ __Returns:__
 
 --
 
+##### [DEFAULT_HEADERS](https://github.com/appium/ruby_lib/blob/7c3bc19905d0f008192a59dc7f5a938e3701ec8f/lib/appium_lib/common/patch.rb#L145) 
+
+> DEFAULT_HEADERS = { 'Accept' => CONTENT_TYPE, 'User-Agent' => "appium/ruby_lib/#{::Appium::VERSION}" }
+
+
+
+--
+