appium_lib 0.3.16 → 0.4.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MzFmNDBlYjA0YjZiNWM4YjJlNzBkMDZmYmE2NDQ3OWE3ZDA1NWU3Nw==
+    YjIzMWRjODRkYzk3YmExNDQ4OWRkOTdhMDU4MGE2ODQ0Zjk2NjBkYg==
   data.tar.gz: !binary |-
-    MjI0NzJjZWZkZGUzMTU2NTAzZmVhYjRkNTUxZjBmZjA0NWM3NGZjMg==
+    YmQyMDMyOTZkYjc0NDFiZWEzNTRkNmI2ODM4YjFkNzdkOTM1ODQyMA==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    YTE4NGE3Y2UzNDk1ZDM0MzM2YTk0NmYzMDUzZWZiZTUzNjYxOWRlMTgzZmVk
-    ZGFjNGM1OWEyMGJlMGVjNGIyODAxOGViNWE4MTJhMTJlN2VmZjViYjMwZjhm
-    MzQ3YmQ0OWE2NDM5ZDVkZjRlMTg2YzliMmI1Y2Y1ZjJkNjQwN2U=
+    NGYzYWEwNDlkMGJmNGM1NTcyYjE3NjRhNjYzODdhN2I3Y2RkNjY3YzQ4NDAz
+    YjAxZWQ0NWRiZjg4NTAzMjMyYTMzYTJkMzA3ZjAyMmI2ZDM5MzM1ZTIzZjM2
+    NzMyMWQ0NzE5NWI3ZDA5M2IzNjNmM2Y0OTg0MDQ3OTAxZjY4Mzc=
   data.tar.gz: !binary |-
-    NjlmMThlMWQ2NjljMmRlZjkzYjFkZmNlNDNmYWY4NjAyYWIyZGQ4ZTU3NDA1
-    ZGY0YzMxNzEzNjBlNWNkYjI3Y2Q0NGMwM2JiYTQ0YjJiZTY4ZGI2NzIwOTc3
-    OTc3ODRkNzdjNDcwOWMyMTY0ZTkwMGY0ZDE5Mjk1MjllYWEwNDU=
+    ZDE1NmE2ZjY5ZDhkMzBmMjQ4ZTU2NTA0NDY5NjA2NzVjMjQ0MzQ2MmEwMDBk
+    MGE1YzIzYWRhZDc4YWY5MjA5YmZlN2RjY2NiMDkyMDRhNjdlOGQ1ZjljMGQ1
+    ZjE3ZGRlOTg2MDkzOTAxYzg1OGVkZTJiOWRiM2UzZmY3ZWE0YWY=

data/Rakefile

@@ -93,15 +93,29 @@ task :install => [ :gem, :uninstall ] do
   sh "gem install --no-rdoc --no-ri --local #{repo_name}-#{version}.gem"
 end
 
+desc 'Update android and iOS docs'
+task :docs do
+  sh "ruby docs_gen/make_docs.rb"
+end
+
 desc 'Update release notes'
 task :notes 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
+  end
+
   tags = `git tag`.split "\n"
+  tags.sort! &tag_sort
   pairs = []
   tags.each_index { |a| pairs.push tags[a] + '...' + tags[a+1] unless tags[a+1].nil? }
 
   notes = ''
 
   dates = `git log --tags --simplify-by-decoration --pretty="format:%d %ad" --date=short`.split "\n"
+
+  pairs.sort! &tag_sort
   pairs.reverse! # pairs are in reverse order.
 
   tag_date = []
@@ -122,7 +136,9 @@ task :notes do
     data.split("\n").each do |line|
       hex = line.match(/[a-zA-Z0-9]+/)[0]
       # use first 7 chars to match GitHub
-      new_data += "- [#{hex[0...7]}](https://github.com/appium/#{gh_name}/commit/#{hex}) #{line.gsub(hex, '').strip}\n"
+      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/docs/android_docs.md

@@ -0,0 +1,1328 @@
+##### [app_path](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def app_path
+
+Returns the value of attribute app_path
+
+--
+
+##### [app_name](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def app_name
+
+Returns the value of attribute app_name
+
+--
+
+##### [app_package](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def app_package
+
+Returns the value of attribute app_package
+
+--
+
+##### [app_activity](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def app_activity
+
+Returns the value of attribute app_activity
+
+--
+
+##### [app_wait_activity](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def app_wait_activity
+
+Returns the value of attribute app_wait_activity
+
+--
+
+##### [sauce_username](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def sauce_username
+
+Returns the value of attribute sauce_username
+
+--
+
+##### [sauce_access_key](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def sauce_access_key
+
+Returns the value of attribute sauce_access_key
+
+--
+
+##### [port](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def port
+
+Returns the value of attribute port
+
+--
+
+##### [os](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def os
+
+Returns the value of attribute os
+
+--
+
+##### [debug](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L38) 
+
+> def debug
+
+Returns the value of attribute debug
+
+--
+
+##### [initialize](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L68) 
+
+> def initialize options={}
+
+Creates a new driver.
+
+```ruby
+# Options include:
+:app_path, :app_name, :app_package, :app_activity,
+:app_wait_activity, :sauce_username, :sauce_access_key,
+:port, :os, :debug
+
+require 'rubygems'
+require 'appium_lib'
+
+# Start iOS driver
+app = { app_path: '/path/to/MyiOS.app'}
+Appium::Driver.new(app).start_driver
+
+# Start Android driver
+apk = { app_path: '/path/to/the.apk',
+        app_package: 'com.example.pkg',
+        app_activity: 'act.Start',
+        app_wait_activity: 'act.Start'
+}
+
+Appium::Driver.new(apk).start_driver
+```
+
+__Parameters:__
+
+     [Object] options - A hash containing various options.
+
+__Returns:__
+
+     [Driver] 
+
+--
+
+##### [absolute_app_path](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L189) 
+
+> def absolute_app_path
+
+Converts environment variable APP_PATH to an absolute path.
+
+__Returns:__
+
+     [String] APP_PATH as an absolute path
+
+--
+
+##### [server_url](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L203) 
+
+> def server_url
+
+Get the server url for sauce or local based on env vars.
+
+__Returns:__
+
+     [String] the server url
+
+--
+
+##### [restart](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L213) 
+
+> def restart
+
+Restarts the driver
+
+__Returns:__
+
+     [Driver] the driver
+
+--
+
+##### [driver](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L220) 
+
+> def driver
+
+Returns the driver
+
+__Returns:__
+
+     [Driver] the driver
+
+--
+
+##### [screenshot](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L228) 
+
+> def screenshot png_save_path
+
+Takes a png screenshot and saves to the target path.
+
+__Parameters:__
+
+     [String] png_save_path - the full path to save the png
+
+__Returns:__
+
+     [void] 
+
+--
+
+##### [driver_quit](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L234) 
+
+> def driver_quit
+
+Quits the driver
+
+__Returns:__
+
+     [void] 
+
+--
+
+##### [start_driver](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L243) 
+
+> def start_driver wait=30
+
+Creates a new global driver and quits the old one if it exists.
+
+__Parameters:__
+
+     [Integer] wait - seconds to wait before timing out a command. defaults to 30 seconds
+
+__Returns:__
+
+     [Selenium::WebDriver] the new global driver
+
+--
+
+##### [no_wait](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L269) 
+
+> def no_wait
+
+Set implicit wait to zero.
+
+--
+
+##### [set_wait](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L276) 
+
+> def set_wait timeout=@default_wait
+
+Set implicit wait to timeout, defaults to 30.
+
+__Parameters:__
+
+     [Integer] timeout - the timeout in seconds
+
+__Returns:__
+
+     [void] 
+
+--
+
+##### [default_wait](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L283) 
+
+> def default_wait
+
+Returns the default client side wait.
+This value is independent of what the server is using
+
+__Returns:__
+
+     [Integer] 
+
+--
+
+##### [exists](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L295) 
+
+> def exists &search_block
+
+Returns existence of element.
+
+Example:
+
+exists { button('sign in') } ? puts('true') : puts('false')
+
+__Parameters:__
+
+     [Block] search_block - the block to call
+
+__Returns:__
+
+     [Boolean] 
+
+--
+
+##### [execute_script](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L320) 
+
+> def execute_script script, *args
+
+The same as @driver.execute_script
+
+__Parameters:__
+
+     [String] script - the script to execute
+
+     [*args] args - the args to pass to the script
+
+__Returns:__
+
+     [Object] 
+
+--
+
+##### [mobile](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L336) 
+
+> def mobile method, *args
+
+Helper method for mobile gestures
+
+https://github.com/appium/appium/wiki/Automating-mobile-gestures
+
+driver.execute_script 'mobile: swipe', endX: 100, endY: 100, duration: 0.01
+
+becomes
+
+mobile :swipe, endX: 100, endY: 100, duration: 0.01
+
+__Parameters:__
+
+     [String, Symbol] method - the method to execute
+
+     [*args] args - the args to pass to the method
+
+__Returns:__
+
+     [Object] 
+
+--
+
+##### [find_elements](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L347) 
+
+> def find_elements *args
+
+Calls @driver.find_elements
+
+__Parameters:__
+
+     [*args] args - the args to use
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] Array is empty when no elements are found.
+
+--
+
+##### [find_element](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L355) 
+
+> def find_element *args
+
+Calls @driver.find_elements
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[*args] args - the args to use
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [x](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/driver.rb#L362) 
+
+> def x
+
+Quit the driver and Pry.
+quit and exit are reserved by Pry.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [wait](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L32) 
+
+> def wait max_wait=30, interval=0.5, &block
+
+Check every 0.5 seconds to see if block.call doesn't raise an exception.
+if .call raises an exception then it will be tried again.
+if .call doesn't raise an exception then it will stop waiting.
+
+Example: wait { name('back').click }
+
+Give up after 30 seconds.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] max_wait - the maximum time in seconds to wait for
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Float] interval - the time in seconds to wait after calling the block
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] block - the block to call
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] the result of block.call
+
+--
+
+##### [wait_true](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L49) 
+
+> def wait_true max_wait=30, interval=0.5, &block
+
+Check every 0.5 seconds to see if block.call returns true. nil is considered a failure.
+Give up after 30 seconds.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] max_wait - the maximum time in seconds to wait for
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Float] interval - the time in seconds to wait after calling the block
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Block] block - the block to call
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Object] the result of block.call
+
+--
+
+##### [id](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L63) 
+
+> def id id
+
+Find by id. Useful for selendroid
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] id - the id to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [back](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L69) 
+
+> def back
+
+Navigate back.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [session_id](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L74) 
+
+> def session_id
+
+For Sauce Labs reporting. Returns the current session id.
+
+--
+
+##### [xpath](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L82) 
+
+> def xpath xpath_str
+
+Returns the first element that matches the provided xpath.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] xpath_str - the XPath string
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [xpaths](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L90) 
+
+> def xpaths xpath_str
+
+Returns all elements that match the provided xpath.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] xpath_str - the XPath string
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
+
+--
+
+##### [ele_index](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L98) 
+
+> def ele_index tag_name, index
+
+Get the element of type tag_name at matching index.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to find
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] index - the index
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the found element of type tag_name
+
+--
+
+##### [find_eles](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L106) 
+
+> def find_eles tag_name
+
+Get all elements exactly matching tag name
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to find
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the found elements of type tag_name
+
+--
+
+##### [find_ele_by_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L114) 
+
+> def find_ele_by_text tag, text
+
+Get the first tag that exactly matches tag and text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to exactly match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag exactly matching text
+
+--
+
+##### [find_eles_by_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L122) 
+
+> def find_eles_by_text tag, text
+
+Get all tags that exactly match tag and text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to exactly match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag exactly matching text
+
+--
+
+##### [find_ele_by_attr_include](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L131) 
+
+> def find_ele_by_attr_include tag, attr, value
+
+Get the first tag by attribute that exactly matches value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must include
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag who's attribute includes value
+
+--
+
+##### [find_eles_by_attr_include](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L140) 
+
+> def find_eles_by_attr_include tag, attr, value
+
+Get tags by attribute that include value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] attr - the attribute to compare
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] value - the value of the attribute that the element must include
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag who's attribute includes value
+
+--
+
+##### [find_ele_by_text_include](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L149) 
+
+> def find_ele_by_text_include tag, text
+
+Get the first tag that includes text.
+element.attribute(:text).include? text
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text the element must include
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element of type tag that includes text
+
+--
+
+##### [find_eles_by_text_include](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L158) 
+
+> def find_eles_by_text_include tag, text
+
+Get the tags that include text.
+element.attribute(:text).include? text
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag - the tag name to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text the element must include
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] the elements of type tag that includes text
+
+--
+
+##### [first_ele](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L165) 
+
+> def first_ele tag_name
+
+Get the first tag that matches tag_name
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag to match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [last_ele](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L173) 
+
+> def last_ele tag_name
+
+Get the last tag that matches tag_name
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag to match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [source](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L179) 
+
+> def source
+
+Prints a JSON view of the current page
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [get_source](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L185) 
+
+> def get_source
+
+Gets a JSON view of the current page
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[JSON] 
+
+--
+
+##### [find_name](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L194) 
+
+> def find_name name
+
+Returns the first element that matches name
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [find_names](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/helper.rb#L202) 
+
+> def find_names name
+
+Returns all elements that match name
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] 
+
+--
+
+##### [dynamic_code_to_string](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/dynamic.rb#L38) 
+
+> def dynamic_code_to_string code, value=false
+
+
+
+--
+
+##### [s_texts](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/text.rb#L8) 
+
+> def s_texts
+
+Get an array of text texts.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>] 
+
+--
+
+##### [e_s_texts](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/text.rb#L14) 
+
+> def e_s_texts
+
+Get an array of text elements.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Text>] 
+
+--
+
+##### [s_first_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/text.rb#L20) 
+
+> def s_first_text
+
+Get the first text element.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+
+--
+
+##### [s_last_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/text.rb#L26) 
+
+> def s_last_text
+
+Get the last text element
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+
+--
+
+##### [s_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/text.rb#L33) 
+
+> def s_text text
+
+Get the first element that includes text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] text - the text to find. If int then the text at that index is returned.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+
+--
+
+##### [s_text_exact](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/text.rb#L41) 
+
+> def s_text_exact text
+
+Get the first textfield that matches text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text that the tag must match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Text] 
+
+--
+
+##### [button](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L8) 
+
+> def button text, number=0
+
+Find a button by text and optionally number.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] text - the text to exactly match. If int then the button at that index is returned.
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] number - the occurrence of the button matching text. Defaults to the first button.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] the button found with text and matching number
+
+--
+
+##### [buttons](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L19) 
+
+> def buttons text=nil
+
+Get an array of button texts or button elements if text is provided.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to exactly match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>, Array<Buttons>] either an array of button texts or an array of button elements if text is provided.
+
+--
+
+##### [first_button](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L26) 
+
+> def first_button
+
+Get the first button element.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+
+--
+
+##### [last_button](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L32) 
+
+> def last_button
+
+Get the last button element.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+
+--
+
+##### [button_exact](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L39) 
+
+> def button_exact text
+
+Get the first button element that exactly matches text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match exactly
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] 
+
+--
+
+##### [buttons_exact](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L46) 
+
+> def buttons_exact text
+
+Get all button elements that exactly match text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match exactly
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
+
+--
+
+##### [e_buttons](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L52) 
+
+> def e_buttons
+
+Get an array of button elements.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Button>] 
+
+--
+
+##### [button_num](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/button.rb#L72) 
+
+> def button_num text, number=1
+
+Expected to be called via button method.
+
+Get the button element exactly matching text and
+occurrence. number=2 means the 2nd occurrence.
+
+find the second Sign In button
+
+b = e_button 'Sign In', 2
+
+Button order will change in iOS vs Android
+so if there's no button found at number then
+return the first button.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer] number - the button occurance to return. 1 = first button
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Button] the button that matches text and number
+
+--
+
+##### [window_size](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/element/window.rb#L5) 
+
+> def window_size
+
+Get the window's size
+
+--
+
+##### [tag_name_to_android](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L6) android
+
+> def tag_name_to_android tag_name
+
+Returns an array of android classes that match the tag name
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to convert to an android class
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [find_eles_attr](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L44) android
+
+> def find_eles_attr tag_name
+
+Find all elements matching the attribute
+On android, assume the attr is name (which falls back to text).
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] tag_name - the tag name to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [get_selendroid_inspect](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L66) android
+
+> def get_selendroid_inspect
+
+Selendroid only.
+Returns a string containing interesting elements.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [get_android_inspect](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L131) android
+
+> def get_android_inspect
+
+Android only.
+Returns a string containing interesting elements.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [get_inspect](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L180) android
+
+> def get_inspect
+
+Automatically detects selendroid or android.
+Returns a string containing interesting elements.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [page](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L186) android
+
+> def page
+
+Intended for use with console.
+Inspects and prints the current page.
+
+--
+
+##### [fast_duration](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/helper.rb#L199) android
+
+> def fast_duration
+
+JavaScript code from https://github.com/appium/appium/blob/master/app/android.js
+
+```javascript
+Math.round((duration * 1000) / 200)
+(.20 * 1000) / 200 = 1
+```
+
+We want steps to be exactly 1. If it's zero then a tap is used instead of a swipe.
+
+--
+
+##### [alert_click](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/alert.rb#L6) android
+
+> def alert_click value
+
+Tap the alert button identified by value.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Integer, String] value - either an integer index of the button or the button's name
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [alert_accept](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/alert.rb#L13) android
+
+> def alert_accept
+
+Accept the alert.
+The last button is considered "accept."
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [alert_accept_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/alert.rb#L20) android
+
+> def alert_accept_text
+
+Get the text of the alert's accept button.
+The last button is considered "accept."
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [alert_dismiss](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/alert.rb#L27) android
+
+> def alert_dismiss
+
+Dismiss the alert.
+The first button is considered "dismiss."
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[void] 
+
+--
+
+##### [alert_dismiss_text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/alert.rb#L34) android
+
+> def alert_dismiss_text
+
+Get the text of the alert's dismiss button.
+The first button is considered "dismiss."
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] 
+
+--
+
+##### [find](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/generic.rb#L44) android
+
+> def find val
+
+Find the value contained in content description or text. Search elements
+in this order: EditText, Button, ImageButton
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] val - the value to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] 
+
+--
+
+##### [text](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/generic.rb#L70) android
+
+> def text text
+
+Return the first element matching text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the first matching element
+
+--
+
+##### [texts](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/generic.rb#L79) android
+
+> def texts text
+
+Return all elements matching text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] all matching elements
+
+--
+
+##### [name](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/generic.rb#L88) android
+
+> def name name
+
+Return the first element matching name.
+on Android name is content description
+on iOS name is the accessibility label or the text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the first matching element
+
+--
+
+##### [names](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/generic.rb#L99) android
+
+> def names name
+
+Return all elements matching name.
+on Android name is content description
+on iOS name is the accessibility label or the text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] name - the name to search for
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Element>] all matching elements
+
+--
+
+##### [scroll_to](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/generic.rb#L106) android
+
+> def scroll_to text
+
+Scroll to an element containing target text or description.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to search for in the text value and content description
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Element] the element scrolled to
+
+--
+
+##### [textfields](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/textfield.rb#L7) android
+
+> def textfields
+
+Get an array of textfield texts.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<String>] 
+
+--
+
+##### [e_textfields](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/textfield.rb#L13) android
+
+> def e_textfields
+
+Get an array of textfield elements.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Array<Textfield>] 
+
+--
+
+##### [first_textfield](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/textfield.rb#L19) android
+
+> def first_textfield
+
+Get the first textfield element.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+
+--
+
+##### [last_textfield](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/textfield.rb#L25) android
+
+> def last_textfield
+
+Get the last textfield element.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+
+--
+
+##### [textfield](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/textfield.rb#L32) android
+
+> def textfield text
+
+Get the first textfield that includes text or name (content description).
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String, Integer] text - the text to search for. If int then the textfield at that index is returned.
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+
+--
+
+##### [textfield_exact](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/android/element/textfield.rb#L45) android
+
+> def textfield_exact text
+
+Get the first textfield that matches text.
+
+__Parameters:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[String] text - the text to match
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Textfield] 
+
+--
+
+##### [value](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/patch.rb#L10) 
+
+> def value
+
+Returns the value attribute
+
+Fixes NoMethodError: undefined method `value' for Selenium::WebDriver::Element
+
+--
+
+##### [name](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/patch.rb#L17) 
+
+> def name
+
+Returns the name attribute
+
+Fixes NoMethodError: undefined method `name' for Selenium::WebDriver::Element
+
+--
+
+##### [tag_name](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/patch.rb#L24) 
+
+> def tag_name
+
+Returns the type attribute
+
+Fixes Selenium::WebDriver::Error::UnknownError: Not yet implemented
+
+--
+
+##### [location_rel](https://github.com/appium/ruby_lib/blob/b30548e58783bc6b20bd5c0f11e2ae9ddb5faa30/lib/appium_lib/common/patch.rb#L36) 
+
+> def location_rel
+
+For use with mobile tap.
+
+```ruby
+execute_script 'mobile: tap', :x => 0.0, :y => 0.98
+```
+
+https://github.com/appium/appium/wiki/Automating-mobile-gestures
+
+__Returns:__
+
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[OpenStruct] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }
+
+--
+