appium_lib 1.0.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4b7d2dfd027a0f998e7f31a5ba2247568e580792
-  data.tar.gz: 324e6e3c36b835cee8a331e452de782b31041160
+  metadata.gz: 2ce40d56e055e92bb34b040b9cb45450084436df
+  data.tar.gz: 2875a0d0a553c563162d3f68c97f3728373edf19
 SHA512:
-  metadata.gz: 3d30760f200fcc1e1990c29d175c46c4a6424485302dd85bfc29e358ce87105863856cb6df467ee02fa67115523cca78267c0753a5d7289b252ff7075a654e6a
-  data.tar.gz: 46d85eb8e78fab845e53a47caa09edee410b64a24580c6e5d6373b4a4a239e614e242183f78e9d7bead0403f95345ca4c13b348d268041530f6e62ce69d47710
+  metadata.gz: 74528e1f5109da1b8773a558b3ea5864fcbc036df7f3af980b22fd28f7c5adb7ee356a619ef5d058c5344d4511d35e3e0b80ca0811447442477c0d485ce5d7b9
+  data.tar.gz: 553b3d43b38502d460fbff85b84a65aff2b55811883d53c93badfc56f5b8b3e23cd1e42ab5e6f53e907dd1a57206c5515f9f2e3cb9a30b1698d7d9f5e292f02e

data/Rakefile

@@ -5,10 +5,23 @@ require 'date'
 require 'posix/spawn'
 
 # Defines gem name.
-def repo_name; 'appium_lib' end # ruby_lib published as appium_lib
-def gh_name; 'ruby_lib' end # the name as used on github.com
-def version_file; "lib/#{repo_name}/common/version.rb" end
-def version_rgx; /\s*VERSION\s*=\s*'([^']+)'/m end
+def repo_name
+  'appium_lib'
+end
+
+# ruby_lib published as appium_lib
+def gh_name
+  'ruby_lib'
+end
+
+# the name as used on github.com
+def version_file
+  "lib/#{repo_name}/common/version.rb"
+end
+
+def version_rgx
+  /\s*VERSION\s*=\s*'([^']+)'/m
+end
 
 def version
   @version = @version || File.read(version_file).match(version_rgx)[1]
@@ -23,8 +36,8 @@ def bump value
   old_v = v_line[0]
   old_d = d_line[0]
 
-  old_num = v_line[1]
-  new_num = old_num.split('.')
+  old_num     = v_line[1]
+  new_num     = old_num.split('.')
   new_num[-1] = new_num[-1].to_i + 1
 
   if value == :y
@@ -33,7 +46,7 @@ def bump value
   elsif value == :x
     new_num[-1] = 0 # x.y.Z -> x.y.0
     new_num[-2] = 0 # x.Y.z -> x.0.z
-    new_num[-3]= new_num[-3].to_i + 1
+    new_num[-3] = new_num[-3].to_i + 1
   end
 
   new_num = new_num.join '.'
@@ -43,7 +56,7 @@ def bump value
 
   old_date = d_line[1]
   new_date = Date.today.to_s
-  new_d = old_d.sub old_date, new_date
+  new_d    = old_d.sub old_date, new_date
   puts "#{old_date} -> #{new_date}" unless old_date == new_date
 
   data.sub! old_v, new_v
@@ -130,11 +143,14 @@ desc 'Uninstall gem'
 task :uninstall do
   cmd = "gem uninstall -aIx #{repo_name}"
   # rescue on gem not installed error.
-  begin; sh "#{cmd}"; rescue; end
+  begin
+    sh "#{cmd}"
+  rescue
+  end
 end
 
 desc 'Install gem'
-task :install => [ :gem, :uninstall ] do
+task :install => [:gem, :uninstall] do
   sh "gem install --no-rdoc --no-ri --local #{repo_name}-#{version}.gem"
 end
 
@@ -145,7 +161,7 @@ end
 
 desc 'Update release notes'
 task :notes do
-  tag_sort = ->(tag1,tag2) do
+  tag_sort = ->(tag1, tag2) do
     tag1_numbers = tag1.match(/\.?v(\d+\.\d+\.\d+)$/)[1].split('.').map! { |n| n.to_i }
     tag2_numbers = tag2.match(/\.?v(\d+\.\d+\.\d+)$/)[1].split('.').map! { |n| n.to_i }
     tag1_numbers <=> tag2_numbers
@@ -176,20 +192,38 @@ task :notes do
   end
 
   pairs.each_index do |a|
-    data =`git log --pretty=oneline #{pairs[a]}`
+    data     =`git log --pretty=oneline #{pairs[a]}`
     new_data = ''
     data.split("\n").each do |line|
-      hex = line.match(/[a-zA-Z0-9]+/)[0]
+      hex     = line.match(/[a-zA-Z0-9]+/)[0]
       # use first 7 chars to match GitHub
       comment = line.gsub(hex, '').strip
       next if comment == 'Update release notes'
       new_data += "- [#{hex[0...7]}](https://github.com/appium/#{gh_name}/commit/#{hex}) #{comment}\n"
     end
-    data = new_data + "\n"
+    data  = new_data + "\n"
 
     # last pair is the released version.
     notes += "#### #{tag_date[a]}\n\n" + data + "\n"
   end
 
   File.open('release_notes.md', 'w') { |f| f.write notes.to_s.strip }
+end
+
+# Used to purge byte order marks that mess up YARD
+def remove_non_ascii
+  Dir.glob('./**/*.rb') do |path|
+    path = File.expand_path path
+    next if File.directory? path
+
+    data = File.read path
+    data = data.encode('US-ASCII', invalid: :replace, undef: :replace, replace: '')
+    data = data.encode('UTF-8')
+    File.open(path, 'w') { |f| f.write data }
+  end
+end
+
+desc 'Remove non-ascii bytes'
+task :byte do
+  remove_non_ascii
 end

data/android_tests/Rakefile

@@ -5,7 +5,10 @@ task :default => :android
 
 # Run sh and ignore exception
 def run_sh cmd
-  begin; sh cmd; rescue; end
+  begin
+    sh cmd
+  rescue
+  end
 end
 
 # Run cmd. On failure run install and try again.
@@ -32,7 +35,7 @@ end
 # rake android
 def run_android test_file=nil
   wait_for_valid_device
-  path = File.expand_path('appium.txt', Rake.application.original_dir)
+  path              = File.expand_path('appium.txt', Rake.application.original_dir)
   ENV['APPIUM_TXT'] = path
   puts "Rake appium.txt path is: #{path}"
   cmd = 'bundle exec ruby ./lib/run.rb android'

data/android_tests/lib/android/specs/android/element/alert.rb

@@ -1,4 +1,4 @@
-describe 'android/element/alert.rb' do
+describe 'android/element/alert' do
   def open_alert
     # trigger the alert
     wait { button('OK Cancel dialog with a long message').click }

data/android_tests/lib/android/specs/android/element/button.rb

@@ -29,6 +29,7 @@ describe 'android/element/button' do
   t 'buttons' do
     exp = ['Zoom in', 'Modern zoom in', 'Thumbnail zoom']
     wait { buttons('zoom').map { |e| e.text }.must_equal exp }
+    wait { buttons.length.must_equal 6 }
   end
 
   t 'first_button' do
@@ -47,9 +48,5 @@ describe 'android/element/button' do
     wait { buttons_exact(fade_in).first.name.must_equal fade_in }
   end
 
-  t 'e_buttons' do
-    wait { e_buttons.length.must_equal 6 }
-  end
-
   t { after_last }
 end

data/android_tests/lib/android/specs/android/element/text.rb

@@ -5,35 +5,32 @@ describe 'android/element/text' do
     proc { block.call }.must_raise Selenium::WebDriver::Error::NoSuchElementError
   end
 
-  t 's_text' do
-    wait { s_text(1).text.must_equal 'API Demos' }
-    wait { s_text('mos').text.must_equal 'API Demos' }
+  t 'text' do
+    wait { text(1).text.must_equal 'API Demos' }
+    wait { text('mos').text.must_equal 'API Demos' }
   end
 
-  t 's_texts' do
-    wait { s_texts('i').length.must_equal 7 }
+  t 'texts' do
+    wait { texts('i').length.must_equal 6 }
+    wait { texts.length.must_equal 12 }
   end
 
-  t 'first_s_text' do
-    wait { first_s_text.text.must_equal 'API Demos' }
+  t 'first_text' do
+    wait { first_text.text.must_equal 'API Demos' }
   end
 
-  t 'last_s_text' do
-    wait { last_s_text.text.must_equal 'Views' }
+  t 'last_text' do
+    wait { last_text.text.must_equal 'Views' }
   end
 
-  t 's_text_exact' do
-    must_raise_no_element { s_text_exact 'mos' }
+  t 'text_exact' do
+    must_raise_no_element { text_exact 'mos' }
 
     # should pass
-    wait { s_text_exact('API Demos').text.must_equal 'API Demos' }
+    wait { text_exact('API Demos').text.must_equal 'API Demos' }
   end
 
-  t 's_texts_exact' do
-    wait { s_texts_exact('API Demos').length.must_equal 1 }
-  end
-
-  t 'e_s_texts' do
-    wait { e_s_texts.length.must_equal 14 }
+  t 'texts_exact' do
+    wait { texts_exact('API Demos').length.must_equal 1 }
   end
 end

data/android_tests/lib/android/specs/android/element/textfield.rb

@@ -32,6 +32,7 @@ describe 'android/element/textfield' do
 
   t 'textfields' do
     wait { textfields('right').first.text.must_equal right }
+    wait { textfields.length.must_equal 2 }
   end
 
   t 'first_textfield' do
@@ -52,9 +53,5 @@ describe 'android/element/textfield' do
     wait { textfields_exact(left).first.text.must_equal left }
   end
 
-  t 'e_textfields' do
-    wait { e_textfields.length.must_equal 2 }
-  end
-
   t { after_last }
 end

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

@@ -1,17 +1,15 @@
 # rake android[android/helper]
 describe 'android/helper' do
   t 'tags' do
-    wait { tags('android.widget.TextView').length.must_equal 14 }
+    wait { tags('android.widget.TextView').length.must_equal 12 }
   end
 
   def page_class_data
     (<<-TXT).strip
-12x android.widget.TextView
-4x android.widget.FrameLayout
-2x android.widget.LinearLayout
-2x android.view.View
+14x android.widget.TextView
+1x android.view.View
 1x android.widget.ListView
-1x android.widget.ImageView
+1x android.widget.FrameLayout
 1x hierarchy
     TXT
   end

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

@@ -20,7 +20,7 @@ describe 'common/device' do
 
   t 'reset' do
     reset
-    wait { s_text(1).text.must_equal 'API Demos' }
+    wait { text(1).text.must_equal 'API Demos' }
   end
 
   t 'close & launch' do
@@ -40,11 +40,16 @@ describe 'common/device' do
     wait { current_context.must_equal 'NATIVE_APP' }
   end
 
-  t 'current_context=' do
+  t 'set_context' do
     wait do
-      current_context= 'WEBVIEW'
-      current_context.must_equal 'WEBVIEW'
+      scroll_to('Views').click
+      scroll_to('WebView').click
+      set_context 'WEBVIEW'
+      current_context.must_equal 'WEBVIEW_1'
     end
+
+    set_context 'NATIVE_APP'
+    2.times { back; sleep 1 }
   end
 
   t 'within_context' do
@@ -90,16 +95,21 @@ describe 'common/device' do
     end
     wait { find_element(:name, 'Custom View') }
     back
+    wait { text_exact 'NFC' }
   end
 
   t 'swipe' do
     wait { Appium::TouchAction.new.swipe(start_x: 0.75, start_y: 0.25, end_x: 0.75, end_y: 0.5, duration: 1.5).perform }
+    wait { !exists { text_exact 'NFC' } }
+    back
+    wait { text_exact 'NFC' }
   end
 
   t 'pinch & zoom' do
+    wait { text_exact 'NFC' }
+    wait { text_exact('Graphics').click }
+    wait { text('BitmapMesh').click }
     wait do
-      s_text('Graphics').click
-      s_text('BitmapMesh').click
       zoom 200
       pinch 75
     end

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

@@ -45,11 +45,11 @@ describe 'common/helper' do
 
   t 'back' do
     # start page
-    wait { e_s_texts.length.must_equal 14 }
+    wait { texts.length.must_equal 12 }
     # nav to new page.
     # ele 0 is the title and can't be clicked.
-    wait { s_text(2).click }
-    wait { e_s_texts.length.must_equal 8 }
+    wait { text(2).click }
+    wait { texts.length.must_equal 5 }
     # go back
     back
     # start page
@@ -65,7 +65,7 @@ describe 'common/helper' do
   end
 
   t 'xpaths' do
-    wait { xpaths('//android.widget.TextView').length.must_equal 14 }
+    wait { xpaths('//android.widget.TextView').length.must_equal 12 }
   end
 
   t 'ele_index' do
@@ -73,7 +73,7 @@ describe 'common/helper' do
   end
 
   t 'tags' do
-    wait { tags('android.widget.TextView').length.must_equal 14 }
+    wait { tags('android.widget.TextView').length.must_equal 12 }
   end
 
   t 'find_ele_by_attr_include' do
@@ -86,7 +86,7 @@ describe 'common/helper' do
   t 'find_eles_by_attr_include' do
     wait do
       ele_count = find_eles_by_attr_include('android.widget.TextView', :text, 'e').length
-      ele_count.must_equal 9
+      ele_count.must_equal 7
     end
   end
 

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

@@ -13,14 +13,14 @@ describe 'common/patch' do
     # t 'value' do; end # Doesn't work on Android
 
     t 'name' do
-      wait { first_s_text.name.must_equal 'API Demos' }
+      wait { first_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 = first_text.location_rel
         loc.x.class.must_equal String
         loc.y.class.must_equal String
       end
@@ -55,7 +55,7 @@ describe 'common/patch' do
     t 'find many elements by resource id' do
       wait do
         value = find_elements(:id, 'android:id/text1').length
-        value.must_equal 13
+        value.must_equal 11
       end
     end
 

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

@@ -158,7 +158,7 @@ describe 'driver' do
     # any elements
     t 'find_elements' do
       wait do
-        find_elements(:class_name, 'android.widget.TextView').length.must_equal 14
+        find_elements(:class_name, 'android.widget.TextView').length.must_equal 12
       end
     end
 

data/appium_lib.gemspec

@@ -1,7 +1,7 @@
 def self.add_to_path path
- path = File.expand_path "../#{path}/", __FILE__
+  path = File.expand_path "../#{path}/", __FILE__
 
- $:.unshift path unless $:.include? path
+  $:.unshift path unless $:.include? path
 end
 
 add_to_path 'lib'
@@ -12,15 +12,15 @@ Gem::Specification.new do |s|
   # 1.8.x is not supported
   s.required_ruby_version = '>= 1.9.3'
 
-  s.name = 'appium_lib'
-  s.version = Appium::VERSION
-  s.date = Appium::DATE
-  s.license = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
-  s.description = s.summary = 'Ruby library for Appium'
-  s.description += '.' # avoid identical warning
-  s.authors = s.email = [ 'code@bootstraponline.com' ]
-  s.homepage = 'https://github.com/appium/ruby_lib' # published as appium_lib
-  s.require_paths = [ 'lib' ]
+  s.name          = 'appium_lib'
+  s.version       = Appium::VERSION
+  s.date          = Appium::DATE
+  s.license       = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+  s.description   = s.summary = 'Ruby library for Appium'
+  s.description   += '.' # avoid identical warning
+  s.authors       = s.email = ['code@bootstraponline.com']
+  s.homepage      = 'https://github.com/appium/ruby_lib' # published as appium_lib
+  s.require_paths = ['lib']
 
   s.add_runtime_dependency 'selenium-webdriver', '~> 2.41', '>= 2.41.0'
   s.add_runtime_dependency 'awesome_print', '~> 1.2', '>= 1.2.0'

data/docs/android_docs.md

@@ -1,4 +1,4 @@
-##### [load_appium_txt](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L71) 
+##### [load_appium_txt](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L71) 
 
 > def self.load_appium_txt opts={}
 
@@ -27,7 +27,7 @@ __Returns:__
 
 --
 
-##### [symbolize_keys](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L141) 
+##### [symbolize_keys](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L141) 
 
 > 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/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L151) 
+##### [promote_singleton_appium_methods](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L151) 
 
 > def self.promote_singleton_appium_methods main_module
 
@@ -46,7 +46,7 @@ https://github.com/rails/docrails/blob/a3b1105ada3da64acfa3843b164b14b734456a50/
 
 --
 
-##### [promote_appium_methods](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L180) 
+##### [promote_appium_methods](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L180) 
 
 > def self.promote_appium_methods class_array
 
@@ -64,7 +64,7 @@ __Parameters:__
 
 --
 
-##### [global_webdriver_http_sleep](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L213) 
+##### [global_webdriver_http_sleep](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L213) 
 
 > def global_webdriver_http_sleep
 
@@ -72,7 +72,7 @@ The amount to sleep in seconds before every webdriver http call.
 
 --
 
-##### [global_webdriver_http_sleep=](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L213) 
+##### [global_webdriver_http_sleep=](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L213) 
 
 > def global_webdriver_http_sleep=(value)
 
@@ -80,7 +80,7 @@ The amount to sleep in seconds before every webdriver http call.
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L234) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L234) 
 
 > def initialize opts={}
 
@@ -111,7 +111,7 @@ __Returns:__
 
 --
 
-##### [driver_attributes](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L308) 
+##### [driver_attributes](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L308) 
 
 > def driver_attributes
 
@@ -119,7 +119,7 @@ Returns a hash of the driver attributes
 
 --
 
-##### [device_is_android?](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L328) 
+##### [device_is_android?](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L328) 
 
 > def device_is_android?
 
@@ -131,7 +131,7 @@ __Returns:__
 
 --
 
-##### [appium_server_version](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L344) 
+##### [appium_server_version](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L344) 
 
 > def appium_server_version
 
@@ -152,7 +152,7 @@ __Returns:__
 
 --
 
-##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L350) 
+##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L350) 
 
 > def self.absolute_app_path app_path
 
@@ -164,7 +164,7 @@ __Returns:__
 
 --
 
-##### [server_url](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L374) 
+##### [server_url](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L374) 
 
 > def server_url
 
@@ -176,7 +176,7 @@ __Returns:__
 
 --
 
-##### [restart](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L385) 
+##### [restart](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L385) 
 
 > def restart
 
@@ -188,7 +188,7 @@ __Returns:__
 
 --
 
-##### [driver](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L392) 
+##### [driver](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L392) 
 
 > def driver
 
@@ -200,7 +200,7 @@ __Returns:__
 
 --
 
-##### [screenshot](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L402) 
+##### [screenshot](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L402) 
 
 > def screenshot png_save_path
 
@@ -218,7 +218,7 @@ __Returns:__
 
 --
 
-##### [driver_quit](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L409) 
+##### [driver_quit](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L409) 
 
 > def driver_quit
 
@@ -230,7 +230,7 @@ __Returns:__
 
 --
 
-##### [start_driver](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L417) 
+##### [start_driver](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L417) 
 
 > def start_driver
 
@@ -242,7 +242,7 @@ __Returns:__
 
 --
 
-##### [no_wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L443) 
+##### [no_wait](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L443) 
 
 > def no_wait
 
@@ -250,7 +250,7 @@ Set implicit wait and default_wait to zero.
 
 --
 
-##### [set_wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L462) 
+##### [set_wait](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L462) 
 
 > def set_wait timeout=nil
 
@@ -275,7 +275,7 @@ __Returns:__
 
 --
 
-##### [default_wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L480) 
+##### [default_wait](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L480) 
 
 > def default_wait
 
@@ -288,7 +288,7 @@ __Returns:__
 
 --
 
-##### [exists](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L496) 
+##### [exists](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L496) 
 
 > def exists pre_check=0, post_check=@default_wait, &search_block
 
@@ -314,7 +314,7 @@ __Returns:__
 
 --
 
-##### [execute_script](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L520) 
+##### [execute_script](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L520) 
 
 > def execute_script script, *args
 
@@ -332,7 +332,7 @@ __Returns:__
 
 --
 
-##### [find_elements](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L528) 
+##### [find_elements](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L528) 
 
 > def find_elements *args
 
@@ -348,7 +348,7 @@ __Returns:__
 
 --
 
-##### [find_element](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L536) 
+##### [find_element](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L536) 
 
 > def find_element *args
 
@@ -364,7 +364,7 @@ __Returns:__
 
 --
 
-##### [x](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/driver.rb#L543) 
+##### [x](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/driver.rb#L543) 
 
 > def x
 
@@ -377,7 +377,7 @@ __Returns:__
 
 --
 
-##### [NoArgMethods](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L7) 
+##### [NoArgMethods](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L7) 
 
 > NoArgMethods = {
 
@@ -385,7 +385,7 @@ __Returns:__
 
 --
 
-##### [app_strings](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L23) 
+##### [app_strings](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L22) 
 
 > def app_strings
 
@@ -396,7 +396,7 @@ app_strings #=> "TransitionsTitle"=>"Transitions", "WebTitle"=>"Web"
 
 --
 
-##### [background_app](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L29) 
+##### [background_app](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L28) 
 
 > def background_app
 
@@ -405,7 +405,7 @@ This is a blocking application
 
 --
 
-##### [current_activity](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L34) 
+##### [current_activity](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L33) 
 
 > def current_activity
 
@@ -413,7 +413,7 @@ This is a blocking application
 
 --
 
-##### [launch](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L36) 
+##### [launch](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L35) 
 
 > def launch
 
@@ -421,7 +421,7 @@ Start the simulator and applicaton configured with desired capabilities
 
 --
 
-##### [reset](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L39) 
+##### [reset](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L38) 
 
 > def reset
 
@@ -429,7 +429,7 @@ Reset the device, relaunching the application.
 
 --
 
-##### [shake](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L42) 
+##### [shake](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L41) 
 
 > def shake
 
@@ -437,7 +437,7 @@ Cause the device to shake
 
 --
 
-##### [toggle_flight_mode](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L45) 
+##### [toggle_flight_mode](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L44) 
 
 > def toggle_flight_mode
 
@@ -445,7 +445,7 @@ toggle flight mode on or off
 
 --
 
-##### [complex_find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L48) 
+##### [complex_find](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L47) 
 
 > def complex_find
 
@@ -466,7 +466,7 @@ __Parameters:__
 
 --
 
-##### [hide_keyboard](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L60) 
+##### [hide_keyboard](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L59) 
 
 > def hide_keyboard
 
@@ -479,7 +479,7 @@ Defaults to 'Done'.
 
 --
 
-##### [key_event](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L69) 
+##### [key_event](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L68) 
 
 > def key_event
 
@@ -493,7 +493,7 @@ __Parameters:__
 
 --
 
-##### [push_file](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L74) 
+##### [push_file](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L73) 
 
 > def push_file
 
@@ -507,7 +507,7 @@ __Parameters:__
 
 --
 
-##### [pull_file](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L79) 
+##### [pull_file](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L78) 
 
 > def pull_file
 
@@ -524,7 +524,7 @@ __Parameters:__
 
 --
 
-##### [extend_search_contexts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L277) 
+##### [extend_search_contexts](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L283) 
 
 > def extend_search_contexts
 
@@ -532,7 +532,7 @@ __Parameters:__
 
 --
 
-##### [accessiblity_id_find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L277) 
+##### [accessiblity_id_find](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L283) 
 
 > def accessiblity_id_find
 
@@ -544,7 +544,7 @@ find_element/s with their accessibility_id
 
 --
 
-##### [add_touch_actions](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L283) 
+##### [add_touch_actions](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L289) 
 
 > def add_touch_actions
 
@@ -552,13 +552,13 @@ find_element/s with their accessibility_id
 
 --
 
-##### [current_context=](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L307) 
+##### [set_context](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L313) 
 
-> def current_context=
+> def set_context
 
 Change the context to the given context.
 ```ruby
-current_context= "NATIVE_APP"
+set_context "NATIVE_APP"
 ```
 
 __Parameters:__
@@ -567,7 +567,7 @@ __Parameters:__
 
 --
 
-##### [current_context](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L315) 
+##### [current_context](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L321) 
 
 > def current_context
 
@@ -579,7 +579,7 @@ __Returns:__
 
 --
 
-##### [available_contexts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L318) 
+##### [available_contexts](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L324) 
 
 > def available_contexts
 
@@ -591,7 +591,7 @@ __Returns:__
 
 --
 
-##### [within_context](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L328) 
+##### [within_context](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L334) 
 
 > def within_context(context)
 
@@ -607,15 +607,15 @@ __Parameters:__
 
 --
 
-##### [switch_to_default_context](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/device.rb#L335) 
+##### [switch_to_default_context](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/device.rb#L342) 
 
 > def switch_to_default_context
 
-Change to the default context.  This is equivalent to `current_context= nil`.
+Change to the default context.  This is equivalent to `set_context nil`.
 
 --
 
-##### [pinch](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L30) 
+##### [pinch](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/multi_touch.rb#L30) 
 
 > def pinch(percentage=25, auto_perform=true)
 
@@ -634,7 +634,7 @@ __Parameters:__
 
 --
 
-##### [zoom](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L58) 
+##### [zoom](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/multi_touch.rb#L58) 
 
 > def zoom(percentage=200, auto_perform=true)
 
@@ -653,7 +653,7 @@ __Parameters:__
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L79) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/multi_touch.rb#L79) 
 
 > def initialize
 
@@ -665,7 +665,7 @@ __Returns:__
 
 --
 
-##### [add](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L85) 
+##### [add](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/multi_touch.rb#L85) 
 
 > def add(chain)
 
@@ -677,7 +677,7 @@ __Parameters:__
 
 --
 
-##### [perform](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/multi_touch.rb#L90) 
+##### [perform](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/multi_touch.rb#L90) 
 
 > def perform
 
@@ -685,15 +685,15 @@ Ask Appium to perform the actions
 
 --
 
-##### [ACTIONS](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L12) 
+##### [ACTIONS](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L12) 
 
-> ACTIONS = [:move_to, :press_for_duration, :press, :release, :tap, :wait, :perform]
+> ACTIONS         = [:move_to, :long_press, :press, :release, :tap, :wait, :perform]
 
 
 
 --
 
-##### [COMPLEX_ACTIONS](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L13) 
+##### [COMPLEX_ACTIONS](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L13) 
 
 > COMPLEX_ACTIONS = [:swipe]
 
@@ -701,7 +701,7 @@ Ask Appium to perform the actions
 
 --
 
-##### [actions](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L27) 
+##### [actions](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L27) 
 
 > def actions
 
@@ -709,7 +709,7 @@ Returns the value of attribute actions
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L29) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L29) 
 
 > def initialize
 
@@ -721,7 +721,7 @@ __Returns:__
 
 --
 
-##### [move_to](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L37) 
+##### [move_to](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L37) 
 
 > def move_to(opts)
 
@@ -733,25 +733,25 @@ __Parameters:__
 
 --
 
-##### [press_for_duration](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L47) 
+##### [long_press](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L47) 
 
-> def press_for_duration(element, x, y, duration)
+> def long_press(opts)
 
 Press down for a specific duration.
 
 __Parameters:__
 
-     [WebDriver::Element] element - the element to press.
+     [Hash] element - a customizable set of options
 
-     [integer] x - x co-ordinate to press on.
+     [Hash] x - a customizable set of options
 
-     [integer] y - y co-ordinate to press on.
+     [Hash] y - a customizable set of options
 
-     [integer] duration - Number of seconds to press.
+     [Hash] duration - a customizable set of options
 
 --
 
-##### [press](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L58) 
+##### [press](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L59) 
 
 > def press(opts)
 
@@ -764,7 +764,7 @@ __Parameters:__
 
 --
 
-##### [release](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L69) 
+##### [release](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L70) 
 
 > def release(opts=nil)
 
@@ -776,7 +776,7 @@ __Parameters:__
 
 --
 
-##### [tap](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L80) 
+##### [tap](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L81) 
 
 > def tap(opts)
 
@@ -788,19 +788,19 @@ __Parameters:__
 
 --
 
-##### [wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L88) 
+##### [wait](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L90) 
 
-> def wait(seconds)
+> def wait(milliseconds)
 
-Pause for a number of seconds before the next action
+Pause for a number of milliseconds before the next action
 
 __Parameters:__
 
-     [integer] seconds - Number of seconds to pause for
+     [integer] milliseconds - Number of milliseconds to pause for
 
 --
 
-##### [swipe](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L99) 
+##### [swipe](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L101) 
 
 > def swipe(opts)
 
@@ -812,7 +812,7 @@ __Parameters:__
 
 --
 
-##### [perform](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L114) 
+##### [perform](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L116) 
 
 > def perform
 
@@ -820,7 +820,7 @@ Ask the driver to perform all actions in this action chain.
 
 --
 
-##### [cancel](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L120) 
+##### [cancel](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L122) 
 
 > def cancel
 
@@ -828,7 +828,7 @@ Does nothing, currently.
 
 --
 
-##### [chain_method](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L128) 
+##### [chain_method](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L130) 
 
 > def chain_method(method, args=nil)
 
@@ -836,7 +836,7 @@ Does nothing, currently.
 
 --
 
-##### [args_with_ele_ref](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/device/touch_actions.rb#L137) 
+##### [args_with_ele_ref](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/device/touch_actions.rb#L139) 
 
 > def args_with_ele_ref(args)
 
@@ -844,7 +844,7 @@ Does nothing, currently.
 
 --
 
-##### [wait](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L33) 
+##### [wait](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L33) 
 
 > def wait max_wait=30, interval=0.5, &block
 
@@ -871,7 +871,7 @@ __Returns:__
 
 --
 
-##### [ignore](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L49) 
+##### [ignore](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L49) 
 
 > def ignore &block
 
@@ -879,7 +879,7 @@ Return block.call and ignore any exceptions.
 
 --
 
-##### [wait_true](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L64) 
+##### [wait_true](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L64) 
 
 > def wait_true max_wait=30, interval=0.5, &block
 
@@ -902,7 +902,7 @@ __Returns:__
 
 --
 
-##### [back](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L81) 
+##### [back](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L81) 
 
 > def back
 
@@ -914,7 +914,7 @@ __Returns:__
 
 --
 
-##### [session_id](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L86) 
+##### [session_id](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L86) 
 
 > def session_id
 
@@ -922,7 +922,7 @@ For Sauce Labs reporting. Returns the current session id.
 
 --
 
-##### [xpath](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L94) 
+##### [xpath](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L94) 
 
 > def xpath xpath_str
 
@@ -938,7 +938,7 @@ __Returns:__
 
 --
 
-##### [xpaths](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L102) 
+##### [xpaths](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L102) 
 
 > def xpaths xpath_str
 
@@ -954,7 +954,7 @@ __Returns:__
 
 --
 
-##### [source](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L108) 
+##### [source](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L108) 
 
 > def source
 
@@ -966,7 +966,7 @@ __Returns:__
 
 --
 
-##### [get_source](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L118) 
+##### [get_source](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L118) 
 
 > def get_source
 
@@ -979,7 +979,7 @@ __Returns:__
 
 --
 
-##### [result](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L125) 
+##### [result](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L125) 
 
 > def result
 
@@ -987,7 +987,7 @@ Returns the value of attribute result
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L127) 
+##### [initialize](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L127) 
 
 > def initialize
 
@@ -999,7 +999,7 @@ __Returns:__
 
 --
 
-##### [reset](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L131) 
+##### [reset](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L131) 
 
 > def reset
 
@@ -1007,7 +1007,7 @@ __Returns:__
 
 --
 
-##### [start_element](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L136) 
+##### [start_element](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L136) 
 
 > def start_element name, attrs = []
 
@@ -1015,7 +1015,7 @@ http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
 --
 
-##### [formatted_result](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L140) 
+##### [formatted_result](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L142) 
 
 > def formatted_result
 
@@ -1023,15 +1023,15 @@ http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
 --
 
-##### [get_page_class](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L151) 
+##### [get_page_class](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L153) 
 
 > def get_page_class
 
-Returns a string of class counts.
+Returns a string of class counts of visible elements.
 
 --
 
-##### [page_class](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L162) 
+##### [page_class](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L164) 
 
 > def page_class
 
@@ -1040,7 +1040,7 @@ Useful for appium_console.
 
 --
 
-##### [px_to_window_rel](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L172) 
+##### [px_to_window_rel](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L174) 
 
 > def px_to_window_rel opts={}
 
@@ -1052,7 +1052,7 @@ px_to_window_rel x: 50, y: 150
 
 --
 
-##### [xml_keys](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L189) 
+##### [xml_keys](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L191) 
 
 > def xml_keys target
 
@@ -1068,7 +1068,7 @@ __Returns:__
 
 --
 
-##### [xml_values](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L197) 
+##### [xml_values](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L199) 
 
 > def xml_values target
 
@@ -1084,7 +1084,7 @@ __Returns:__
 
 --
 
-##### [resolve_id](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/helper.rb#L205) 
+##### [resolve_id](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/helper.rb#L207) 
 
 > def resolve_id id
 
@@ -1100,7 +1100,7 @@ __Returns:__
 
 --
 
-##### [window_size](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/common/element/window.rb#L5) 
+##### [window_size](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/element/window.rb#L5) 
 
 > def window_size
 
@@ -1108,7 +1108,7 @@ Get the window's size
 
 --
 
-##### [result](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L7) android
+##### [result](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L7) android
 
 > def result
 
@@ -1116,7 +1116,7 @@ TODO: Support strings.xml ids
 
 --
 
-##### [keys](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L7) android
+##### [keys](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L7) android
 
 > def keys
 
@@ -1124,7 +1124,7 @@ TODO: Support strings.xml ids
 
 --
 
-##### [filter](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L9) android
+##### [filter](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L9) android
 
 > def filter
 
@@ -1132,7 +1132,7 @@ TODO: Support strings.xml ids
 
 --
 
-##### [filter=](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L14) android
+##### [filter=](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L14) android
 
 > def filter= value
 
@@ -1140,7 +1140,7 @@ convert to string to support symbols
 
 --
 
-##### [initialize](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L20) android
+##### [initialize](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L20) android
 
 > def initialize
 
@@ -1152,7 +1152,7 @@ __Returns:__
 
 --
 
-##### [reset](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L25) android
+##### [reset](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L25) android
 
 > def reset
 
@@ -1160,7 +1160,7 @@ __Returns:__
 
 --
 
-##### [start_element](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L31) android
+##### [start_element](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L31) android
 
 > def start_element name, attrs = []
 
@@ -1168,7 +1168,7 @@ http://nokogiri.org/Nokogiri/XML/SAX/Document.html
 
 --
 
-##### [get_android_inspect](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L65) android
+##### [get_android_inspect](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L88) android
 
 > def get_android_inspect class_name=false
 
@@ -1187,17 +1187,17 @@ __Returns:__
 
 --
 
-##### [page](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L80) android
+##### [page](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L103) android
 
-> def page class_name=false
+> def page opts={}
 
 Intended for use with console.
 Inspects and prints the current page.
-if false (default) then all classes will be inspected
+if nil (default) then all classes will be inspected
 
 __Parameters:__
 
-     [String] class_name - the class name to filter on.
+     [Hash] class - a customizable set of options
 
 __Returns:__
 
@@ -1205,7 +1205,7 @@ __Returns:__
 
 --
 
-##### [current_app](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L88) android
+##### [current_app](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L112) android
 
 > def current_app
 
@@ -1215,11 +1215,11 @@ noinspection RubyArgCount
 
 --
 
-##### [id](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L102) android
+##### [id](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L137) android
 
 > def id id
 
-Find by id
+Find the first matching element by id
 
 __Parameters:__
 
@@ -1231,7 +1231,23 @@ __Returns:__
 
 --
 
-##### [ele_index](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L116) android
+##### [ids](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L144) android
+
+> def ids id
+
+Find all matching elements by id
+
+__Parameters:__
+
+     [String] id - the id to search for
+
+__Returns:__
+
+     [Element] 
+
+--
+
+##### [ele_index](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L152) android
 
 > def ele_index class_name, index
 
@@ -1249,7 +1265,7 @@ __Returns:__
 
 --
 
-##### [find_ele_by_attr](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L134) android
+##### [find_ele_by_attr](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L170) android
 
 > def find_ele_by_attr class_name, attr, value
 
@@ -1269,7 +1285,7 @@ __Returns:__
 
 --
 
-##### [find_eles_by_attr](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L143) android
+##### [find_eles_by_attr](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L179) android
 
 > def find_eles_by_attr class_name, attr, value
 
@@ -1289,7 +1305,7 @@ __Returns:__
 
 --
 
-##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L157) android
+##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L193) android
 
 > def find_ele_by_attr_include class_name, attr, value
 
@@ -1309,7 +1325,7 @@ __Returns:__
 
 --
 
-##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L166) android
+##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L202) android
 
 > def find_eles_by_attr_include class_name, attr, value
 
@@ -1329,7 +1345,7 @@ __Returns:__
 
 --
 
-##### [first_ele](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L173) android
+##### [first_ele](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L209) android
 
 > def first_ele class_name
 
@@ -1345,7 +1361,7 @@ __Returns:__
 
 --
 
-##### [last_ele](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L181) android
+##### [last_ele](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L217) android
 
 > def last_ele class_name
 
@@ -1361,7 +1377,7 @@ __Returns:__
 
 --
 
-##### [tag](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L189) android
+##### [tag](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L225) android
 
 > def tag class_name
 
@@ -1377,7 +1393,7 @@ __Returns:__
 
 --
 
-##### [tags](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L197) android
+##### [tags](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L233) android
 
 > def tags class_name
 
@@ -1393,7 +1409,7 @@ __Returns:__
 
 --
 
-##### [xpath_visible_contains](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L232) android
+##### [xpath_visible_contains](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L268) android
 
 > def xpath_visible_contains element, value
 
@@ -1411,7 +1427,7 @@ __Returns:__
 
 --
 
-##### [xpaths_visible_contains](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L240) android
+##### [xpaths_visible_contains](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L276) android
 
 > def xpaths_visible_contains element, value
 
@@ -1429,7 +1445,7 @@ __Returns:__
 
 --
 
-##### [xpath_visible_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L266) android
+##### [xpath_visible_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L302) android
 
 > def xpath_visible_exact element, value
 
@@ -1447,7 +1463,7 @@ __Returns:__
 
 --
 
-##### [xpaths_visible_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/helper.rb#L274) android
+##### [xpaths_visible_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/helper.rb#L310) android
 
 > def xpaths_visible_exact element, value
 
@@ -1465,7 +1481,7 @@ __Returns:__
 
 --
 
-##### [TextView](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L4) android
+##### [TextView](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L4) android
 
 > TextView = 'android.widget.TextView'
 
@@ -1473,9 +1489,9 @@ __Returns:__
 
 --
 
-##### [s_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L10) android
+##### [text](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L10) android
 
-> def s_text value
+> def text value
 
 Find the first TextView that contains value or by index.
 If int then the TextView at that index is returned.
@@ -1490,11 +1506,12 @@ __Returns:__
 
 --
 
-##### [s_texts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L18) android
+##### [texts](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L19) android
 
-> def s_texts value
+> def texts value=false
 
 Find all TextViews containing value.
+If value is omitted, all texts are returned.
 
 __Parameters:__
 
@@ -1506,9 +1523,9 @@ __Returns:__
 
 --
 
-##### [first_s_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L24) android
+##### [first_text](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L26) android
 
-> def first_s_text
+> def first_text
 
 Find the first TextView.
 
@@ -1518,9 +1535,9 @@ __Returns:__
 
 --
 
-##### [last_s_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L30) android
+##### [last_text](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L32) android
 
-> def last_s_text
+> def last_text
 
 Find the last TextView.
 
@@ -1530,9 +1547,9 @@ __Returns:__
 
 --
 
-##### [s_text_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L37) android
+##### [text_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L39) android
 
-> def s_text_exact value
+> def text_exact value
 
 Find the first TextView that exactly matches value.
 
@@ -1546,9 +1563,9 @@ __Returns:__
 
 --
 
-##### [s_texts_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L44) android
+##### [texts_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/text.rb#L46) android
 
-> def s_texts_exact value
+> def texts_exact value
 
 Find all TextViews that exactly match value.
 
@@ -1562,19 +1579,7 @@ __Returns:__
 
 --
 
-##### [e_s_texts](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/text.rb#L50) android
-
-> def e_s_texts
-
-Find all TextViews.
-
-__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
+##### [alert_click](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/alert.rb#L6) android
 
 > def alert_click value
 
@@ -1590,7 +1595,7 @@ __Returns:__
 
 --
 
-##### [alert_accept](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L13) android
+##### [alert_accept](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/alert.rb#L13) android
 
 > def alert_accept
 
@@ -1603,7 +1608,7 @@ __Returns:__
 
 --
 
-##### [alert_accept_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L20) android
+##### [alert_accept_text](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/alert.rb#L20) android
 
 > def alert_accept_text
 
@@ -1616,7 +1621,7 @@ __Returns:__
 
 --
 
-##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L27) android
+##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/alert.rb#L27) android
 
 > def alert_dismiss
 
@@ -1629,7 +1634,7 @@ __Returns:__
 
 --
 
-##### [alert_dismiss_text](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/alert.rb#L34) android
+##### [alert_dismiss_text](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/alert.rb#L34) android
 
 > def alert_dismiss_text
 
@@ -1642,7 +1647,7 @@ __Returns:__
 
 --
 
-##### [uiautomator_find](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/mobile_methods.rb#L10) android
+##### [uiautomator_find](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/mobile_methods.rb#L10) android
 
 > def uiautomator_find
 
@@ -1654,7 +1659,7 @@ find_element/s can be used with a [UISelector](http://developer.android.com/tool
 
 --
 
-##### [Button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L4) android
+##### [Button](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L4) android
 
 > Button      = 'android.widget.Button'
 
@@ -1662,7 +1667,7 @@ find_element/s can be used with a [UISelector](http://developer.android.com/tool
 
 --
 
-##### [ImageButton](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L5) android
+##### [ImageButton](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L5) android
 
 > ImageButton = 'android.widget.ImageButton'
 
@@ -1670,7 +1675,7 @@ find_element/s can be used with a [UISelector](http://developer.android.com/tool
 
 --
 
-##### [button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L39) android
+##### [button](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L39) android
 
 > def button value
 
@@ -1687,11 +1692,12 @@ __Returns:__
 
 --
 
-##### [buttons](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L55) android
+##### [buttons](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L56) android
 
-> def buttons value
+> def buttons value=false
 
-Find all buttons containing value
+Find all buttons containing value.
+If value is omitted, all buttons are returned.
 
 __Parameters:__
 
@@ -1703,7 +1709,7 @@ __Returns:__
 
 --
 
-##### [first_button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L61) android
+##### [first_button](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L63) android
 
 > def first_button
 
@@ -1715,7 +1721,7 @@ __Returns:__
 
 --
 
-##### [last_button](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L67) android
+##### [last_button](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L69) android
 
 > def last_button
 
@@ -1727,7 +1733,7 @@ __Returns:__
 
 --
 
-##### [button_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L74) android
+##### [button_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L76) android
 
 > def button_exact value
 
@@ -1743,7 +1749,7 @@ __Returns:__
 
 --
 
-##### [buttons_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L81) android
+##### [buttons_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/button.rb#L83) android
 
 > def buttons_exact value
 
@@ -1759,19 +1765,7 @@ __Returns:__
 
 --
 
-##### [e_buttons](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/button.rb#L87) android
-
-> def e_buttons
-
-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
+##### [find](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/generic.rb#L7) android
 
 > def find value
 
@@ -1787,7 +1781,7 @@ __Returns:__
 
 --
 
-##### [finds](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L14) android
+##### [finds](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/generic.rb#L14) android
 
 > def finds value
 
@@ -1803,7 +1797,7 @@ __Returns:__
 
 --
 
-##### [find_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L21) android
+##### [find_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/generic.rb#L21) android
 
 > def find_exact value
 
@@ -1819,7 +1813,7 @@ __Returns:__
 
 --
 
-##### [finds_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L28) android
+##### [finds_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/generic.rb#L28) android
 
 > def finds_exact value
 
@@ -1835,7 +1829,7 @@ __Returns:__
 
 --
 
-##### [scroll_to](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L35) android
+##### [scroll_to](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/generic.rb#L35) android
 
 > def scroll_to text
 
@@ -1851,7 +1845,7 @@ __Returns:__
 
 --
 
-##### [scroll_to_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/generic.rb#L48) android
+##### [scroll_to_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/generic.rb#L48) android
 
 > def scroll_to_exact text
 
@@ -1867,7 +1861,7 @@ __Returns:__
 
 --
 
-##### [EditText](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L3) android
+##### [EditText](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L3) android
 
 > EditText = 'android.widget.EditText'
 
@@ -1875,7 +1869,7 @@ __Returns:__
 
 --
 
-##### [textfield](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L9) android
+##### [textfield](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L9) android
 
 > def textfield value
 
@@ -1892,11 +1886,12 @@ __Returns:__
 
 --
 
-##### [textfields](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L17) android
+##### [textfields](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L18) android
 
-> def textfields value
+> def textfields value=false
 
 Find all EditTexts containing value.
+If value is omitted, all EditTexts are returned.
 
 __Parameters:__
 
@@ -1908,7 +1903,7 @@ __Returns:__
 
 --
 
-##### [first_textfield](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L23) android
+##### [first_textfield](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L25) android
 
 > def first_textfield
 
@@ -1920,7 +1915,7 @@ __Returns:__
 
 --
 
-##### [last_textfield](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L29) android
+##### [last_textfield](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L31) android
 
 > def last_textfield
 
@@ -1932,7 +1927,7 @@ __Returns:__
 
 --
 
-##### [textfield_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L36) android
+##### [textfield_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L38) android
 
 > def textfield_exact value
 
@@ -1948,7 +1943,7 @@ __Returns:__
 
 --
 
-##### [textfields_exact](https://github.com/appium/ruby_lib/blob/5a3ecbb4147693ce3c2c6b693e64074022d03511/lib/appium_lib/android/element/textfield.rb#L43) android
+##### [textfields_exact](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/android/element/textfield.rb#L45) android
 
 > def textfields_exact value
 
@@ -1964,19 +1959,7 @@ __Returns:__
 
 --
 
-##### [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) 
+##### [value](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/patch.rb#L10) 
 
 > def value
 
@@ -1986,7 +1969,7 @@ 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) 
+##### [name](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/patch.rb#L17) 
 
 > def name
 
@@ -1996,7 +1979,7 @@ 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) 
+##### [location_rel](https://github.com/appium/ruby_lib/blob/2d7ab8b6cc442f39f6171f8a27bc4923e4d4e2a4/lib/appium_lib/common/patch.rb#L29) 
 
 > def location_rel