appium_lib 0.3.16 → 0.4.0

data/lib/appium_lib/common/version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module Appium
   # Version and Date are defined on the 'Appium' module, not 'Appium::Common'
-  VERSION = '0.3.16' unless defined? ::Appium::VERSION
-  DATE = '2013-05-14' unless defined? ::Appium::DATE
+  VERSION = '0.4.0' unless defined? ::Appium::VERSION
+  DATE = '2013-05-16' unless defined? ::Appium::DATE
 end

data/lib/appium_lib/driver.rb

@@ -13,6 +13,7 @@ module Appium
   require 'common/helper'
   require 'common/patch'
   require 'common/version'
+  require 'common/dynamic'
   require 'common/element/button'
   require 'common/element/text'
   require 'common/element/window'
@@ -36,7 +37,34 @@ module Appium
 
     attr_reader :app_path, :app_name, :app_package, :app_activity,
                 :app_wait_activity, :sauce_username, :sauce_access_key,
-                :port, :os, :ios_js, :debug
+                :port, :os, :debug
+    # 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
+    # ```
+    #
+    # @param options [Object] A hash containing various options.
+    # @return [Driver]
     def initialize options={}
       # quit last driver
       $driver.driver_quit if $driver
@@ -86,7 +114,6 @@ module Appium
         # load Android specific methods
         extend Appium::Android
       else
-        @ios_js = [] # used to keep track of loaded JavaScript on iOS
         # load iOS specific methods
         extend Appium::Ios
       end
@@ -118,8 +145,11 @@ module Appium
           end
         end
       end
+
+      self # return newly created driver
     end # def initialize
 
+    # @private
     # WebDriver capabilities. Must be valid for Sauce to work.
     # https://github.com/jlipps/appium/blob/master/app/android.js
     def android_capabilities
@@ -136,6 +166,7 @@ module Appium
       }
     end
 
+    # @private
     # WebDriver capabilities. Must be valid for Sauce to work.
     def ios_capabilities
       {
@@ -148,6 +179,7 @@ module Appium
       }
     end
 
+    # @private
     def capabilities
       @os == :ios ? ios_capabilities : android_capabilities
     end
@@ -177,16 +209,22 @@ module Appium
     end
 
     # Restarts the driver
+    # @return [Driver] the driver
     def restart
       driver_quit
       start_driver
     end
 
-    # return driver
+    # Returns the driver
+    # @return [Driver] the driver
     def driver
       @driver
     end
 
+    # Takes a png screenshot and saves to the target path.
+    #
+    # @param png_save_path [String] the full path to save the png
+    # @return [void]
     def screenshot png_save_path
       @driver.save_screenshot png_save_path
     end
@@ -199,6 +237,8 @@ module Appium
     end
 
     # Creates a new global driver and quits the old one if it exists.
+    #
+    # @param wait [Integer] seconds to wait before timing out a command. defaults to 30 seconds
     # @return [Selenium::WebDriver] the new global driver
     def start_driver wait=30
       @client = @client || Selenium::WebDriver::Remote::Http::Default.new
@@ -250,6 +290,7 @@ module Appium
     #
     # exists { button('sign in') } ? puts('true') : puts('false')
     #
+    # @param search_block [Block] the block to call
     # @return [Boolean]
     def exists &search_block
       pre_check = 0
@@ -273,7 +314,9 @@ module Appium
     end
 
     # The same as @driver.execute_script
-    # @return [Object] the object returned by execute_script
+    # @param script [String] the script to execute
+    # @param args [*args] the args to pass to the script
+    # @return [Object]
     def execute_script script, *args
       @driver.execute_script script, *args
     end
@@ -282,36 +325,40 @@ module Appium
     #
     # https://github.com/appium/appium/wiki/Automating-mobile-gestures
     #
-    # @driver.execute_script 'mobile: swipe', endX: 100, endY: 100, duration: 0.01
+    # driver.execute_script 'mobile: swipe', endX: 100, endY: 100, duration: 0.01
     #
     # becomes
     #
     # mobile :swipe, endX: 100, endY: 100, duration: 0.01
+    # @param method [String, Symbol] the method to execute
+    # @param args [*args] the args to pass to the method
+    # @return [Object]
     def mobile method, *args
       raise 'Method must not be nil' if method.nil?
       raise 'Method must have .to_s' unless method.respond_to? :to_s
 
-      if method.to_s.strip.downcase == 'reset'
-        # reset will undefine custom iOS JavaScript
-        # mark js as unloaded so it'll reload next use.
-        @ios_js = [] if @ios_js
-      end
-
       @driver.execute_script "mobile: #{method.to_s}", *args
     end
 
     # Calls @driver.find_elements
+    #
+    # @param args [*args] the args to use
+    # @return [Array<Element>] Array is empty when no elements are found.
     def find_elements *args
       @driver.find_elements *args
     end
 
     # Calls @driver.find_elements
+    #
+    # @param args [*args] the args to use
+    # @return [Element]
     def find_element *args
       @driver.find_element *args
     end
 
     # Quit the driver and Pry.
     # quit and exit are reserved by Pry.
+    # @return [void]
     def x
       driver_quit
       exit # exit pry
@@ -322,4 +369,4 @@ end # end module Appium
 # Paging in Pry is annoying :q required to exit.
 # With pager disabled, the output is similar to IRB
 # Only set if Pry is defined.
-Pry.config.pager = false if defined?(Pry)
+Pry.config.pager = false if defined?(Pry)

data/lib/appium_lib/ios/element/generic.rb

@@ -19,14 +19,8 @@ module Appium::Ios
   Android name = iOS name & label
   Android text = iOS value
 =end
-  def ios_js_loaded? method_name
-    @ios_js.include? method_name
-  end
-
-  def ios_js_load method_name
-    @ios_js.push method_name
-  end
 
+  # @private
   # returnElems requires a wrapped $(element).
   # set to empty array when length is zero to prevent hang.
   #
@@ -44,6 +38,8 @@ module Appium::Ios
   # must break instead of return because it's not a function.
   #
   # single element length is undefined when found and 0 when not found.
+  # @param predicate [String] the predicate
+  # @return [String] the completed JavaScript program
   def first_ele_js predicate
     <<-JS
     function isNil( a ) {
@@ -94,6 +90,9 @@ module Appium::Ios
     JS
   end
 
+  # @private
+  # @param predicate [String] the predicate
+  # @return [String] the completed JavaScript program
   def all_ele_js predicate
     <<-JS
       var w = au.mainWindow;

data/lib/appium_lib/ios/element/textfield.rb

@@ -72,6 +72,7 @@ module Appium::Ios
     execute_script js
   end
 
+  # @private
   # Return combined lookup of textfield and secure
   # with an optional filter. $() wrap is required for .each
   def textfield_js filter=''

data/lib/appium_lib/ios/helper.rb

@@ -4,7 +4,7 @@ module Appium::Ios
   # Get an array of attribute values from elements exactly matching tag name.
   # @param tag_name [String] the tag name to find
   # @param attribute [String] the attribute to collect
-  # @result [Array<String>] an array of strings containing the attribute from found elements of type tag_name.
+  # @return [Array<String>] an array of strings containing the attribute from found elements of type tag_name.
   def find_eles_attr tag_name, attribute
     # Use au.lookup(tag_name) instead of $(tag_name)
     # See https://github.com/appium/appium/issues/214
@@ -25,7 +25,7 @@ module Appium::Ios
   # @param tag_name_1 [String] the 1st tag name to find
   # @param tag_name_2 [String] the 2nd tag name to find
   # @param attribute [String] the attribute to collect
-  # @result [Array<String>] an array of strings containing the attribute from found elements of type tag_name.
+  # @return [Array<String>] an array of strings containing the attribute from found elements of type tag_name.
   def find_2_eles_attr tag_name_1, tag_name_2, attribute
     # Use au.lookup(tag_name) instead of $(tag_name)
     # See https://github.com/appium/appium/issues/214
@@ -51,12 +51,18 @@ module Appium::Ios
     '•' * length
   end
 
-  def get_page element
+  # Returns a string of interesting elements. iOS only.
+  #
+  # @param element [Object] the element to search. omit to search everything
+  # @return [String]
+  def get_page element=get_source
 
+    # @private
     def empty ele
       (ele['name'] || ele['label'] || ele['value']) == nil
     end
 
+    # @private
     def fix_space s
       # ints don't respond to force encoding
       return s unless s.respond_to? :force_encoding
@@ -92,11 +98,15 @@ module Appium::Ios
     nil
   end
 
+  # Prints a string of interesting elements to the console.
+  # @return [void]
   def page
-    get_page get_source
+    get_page
     nil
   end
 
+  # The fastest duration that can be used on iOS.
+  # @return [Float]
   def fast_duration
     0.5
   end

data/lib/appium_lib/ios/patch.rb

@@ -1,5 +1,6 @@
 # encoding: utf-8
 module Appium::Ios
+  # @private
   # class_eval inside a method because class Selenium::WebDriver::Element
   # will trigger as soon as the file is required. in contrast a method
   # will trigger only when invoked.
@@ -14,19 +15,6 @@ module Appium::Ios
         JS
         @driver.execute_script js
       end
-
-      # returns if the element is visible
-      # true: 1 = visible,
-      # false: 0 = not visible, null = unknown
-      #
-      # http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Reference/UIAElementClassReference/UIAElement/UIAElement.html#//apple_ref/doc/uid/TP40009903
-      def visible
-        js = <<-JS
-          au.getElement('#{self.ref}').isVisible();
-        JS
-        result = @driver.execute_script js
-        result == 1 ? true : false
-      end
     end
   end
 end

data/readme.md

@@ -72,4 +72,6 @@ Appium::Driver.new(apk).start_driver
 
 #### Documentation
 
-See [docs.md](https://github.com/appium/ruby_lib/blob/master/docs.md)
+- [Overview ](https://github.com/appium/ruby_lib/blob/master/docs/docs.md) 
+- [Android methods](https://github.com/appium/ruby_lib/blob/master/docs/android_docs.md)
+- [iOS methods](https://github.com/appium/ruby_lib/blob/master/docs/ios_docs.md)

data/release_notes.md

@@ -1,143 +1,13 @@
-#### v0.3.9 2013-05-06
-
-- [3b4fbb4](https://github.com/appium/ruby_lib/commit/3b4fbb4e6957a92ac4236d5666d932ee9da238e7) Release 0.3.9
-- [98b1b1e](https://github.com/appium/ruby_lib/commit/98b1b1e8e0952244c1ca2c8738d7d33af7eb0f68) Fix extra slashes in path
-- [4c43359](https://github.com/appium/ruby_lib/commit/4c433597c4409ab7c89e395297d2a6af3c6c439d) Update release notes
-
-
-#### v0.3.8 2013-05-06
-
-- [e7bc45f](https://github.com/appium/ruby_lib/commit/e7bc45fd88f026dc51237d767da9f9dfa2e05b56) Release 0.3.8
-- [dc3a50f](https://github.com/appium/ruby_lib/commit/dc3a50f23ca6ba4978ddb9af1dadf6c6015eb9fb) Use 4.2 not 4.1
-- [f8042f1](https://github.com/appium/ruby_lib/commit/f8042f158f046815238463a9ea86cd66ea725942) Fix page Selendroid
-- [f9866e0](https://github.com/appium/ruby_lib/commit/f9866e034ea9a3744387fb15d5ca3ba221f27429) Load touch methods
-- [c3f9a2b](https://github.com/appium/ruby_lib/commit/c3f9a2b0300ee238acf4ce750f9b651ff39eb919) Don't set timeout on Selendroid until it's fixed
-- [d88245e](https://github.com/appium/ruby_lib/commit/d88245efe8fed5927e136719a9747b788dbd0fc2) Add page for Selendroid
-- [ff63433](https://github.com/appium/ruby_lib/commit/ff63433db6d68170ef135e151d6ac154c3504f4f) Add id method
-- [c59f7ce](https://github.com/appium/ruby_lib/commit/c59f7cefc76a9f172e6e6494aca275b5687d1a74) Improve debugging
-- [873bed9](https://github.com/appium/ruby_lib/commit/873bed9c3d30d0c4a64a497c9636c53275ab943f) Update release notes
-
-
-#### v0.3.7 2013-05-01
-
-- [edfd20a](https://github.com/appium/ruby_lib/commit/edfd20a6ffdef8484b9f7b5eddb9c21815241d42) Release 0.3.7
-- [9f8511c](https://github.com/appium/ruby_lib/commit/9f8511c1416867df606dfb3d058f83ee277ce39a) Remove puts
-- [366da1f](https://github.com/appium/ruby_lib/commit/366da1f6e3c0621d55920bce244fc5aedd678e7d) Update release notes
-
-
-#### v0.3.6 2013-05-01
-
-- [67e5c86](https://github.com/appium/ruby_lib/commit/67e5c867d38251687dc7ebd5de013db5712fcac3) Release 0.3.6
-- [a0a46f7](https://github.com/appium/ruby_lib/commit/a0a46f773a57c9ef7b92252afed467bd7cd01b96) Fix wait and add wait_true
-- [e7cde77](https://github.com/appium/ruby_lib/commit/e7cde775473bd3981cac5b356f78289f832091a9) Add wait example
-- [68a2fdd](https://github.com/appium/ruby_lib/commit/68a2fdde6851f8b24b953a380073b4957f128f06) Update release notes
-
-
-#### v0.3.5 2013-04-30
-
-- [a886ef4](https://github.com/appium/ruby_lib/commit/a886ef4722a902fdef15ecfc7164299399f1d524) Release 0.3.5
-- [193eb71](https://github.com/appium/ruby_lib/commit/193eb716023f52506cdf599cff6aae4f4a3c1119) Fix JSON.parse
-- [54ba323](https://github.com/appium/ruby_lib/commit/54ba323721a704d3ceb34f71dd8e1fcf9069dd78) Use upstream get name contains
-- [6f66b46](https://github.com/appium/ruby_lib/commit/6f66b46725ee397cc437901e95431ec95935d9c2) Name contains moved upstream
-- [2d33b5c](https://github.com/appium/ruby_lib/commit/2d33b5ce4078d784f7f6f0ac07651166a466b34c) Update readme.md
-- [4a1f87e](https://github.com/appium/ruby_lib/commit/4a1f87e1f0524595d7bd15027b4a009a42b5ff83) Update example
-- [6177c49](https://github.com/appium/ruby_lib/commit/6177c497f9c114203e624f530e51f4f54a61788a) Rename get_wait
-- [e33f8fb](https://github.com/appium/ruby_lib/commit/e33f8fb96a97c30d765fe8b98288493b51dcb41c) Update release notes
-
-
-#### v0.3.4 2013-04-30
-
-- [ffdf104](https://github.com/appium/ruby_lib/commit/ffdf104ffdecb165cfe410976145134768756e30) Release 0.3.4
-- [4edc9f6](https://github.com/appium/ruby_lib/commit/4edc9f6097e29d2816dceef546a819fd6ee431d2) Add params to wait
-- [da1c042](https://github.com/appium/ruby_lib/commit/da1c0424873fa5f859b1ec558356a3ad0721097b) Add selendroid launch support
-- [f398041](https://github.com/appium/ruby_lib/commit/f398041369884d8068950ab9e703a8a2d750082c) Use symbols for driver opts
-- [cf09a0d](https://github.com/appium/ruby_lib/commit/cf09a0d1ca8de835043f855cbd74ced9abb5f1b0) Add expected server opts
-- [fe6c7d7](https://github.com/appium/ruby_lib/commit/fe6c7d71dbaf7f7b383d117918de2498945406d4) Fix os specific patches
-- [d9b9c1a](https://github.com/appium/ruby_lib/commit/d9b9c1a2fcc1857e0e7c78d250fd59b84726d69b) Improve logging
-- [3b831b0](https://github.com/appium/ruby_lib/commit/3b831b089e02c4a53585d90ed009f5ad3cb982a7) Return invisible match if no visible result
-- [cdb11b6](https://github.com/appium/ruby_lib/commit/cdb11b6facde318af2524499c6473ea736865dde) Update release notes
-
-
-#### v0.3.3 2013-04-27
-
-- [b0ca37c](https://github.com/appium/ruby_lib/commit/b0ca37cfe47318f029e1f2ad498a5c08338016d7) Release 0.3.3
-- [e7f55d9](https://github.com/appium/ruby_lib/commit/e7f55d92181660ea188a5123e6e4f447389c8d6d) Add driver method
-- [6d381fe](https://github.com/appium/ruby_lib/commit/6d381fe029bd9a5c11aa4d1a322d6afb603c6434) Update readme.md
-- [07da208](https://github.com/appium/ruby_lib/commit/07da208973ea4de64ec9605ef5dd38884771e8c6) Add troubleshooting steps
-- [7df8ddc](https://github.com/appium/ruby_lib/commit/7df8ddcd0edb294abaddd2424f0f6b45f086fb53) Update release notes
-
-
-#### v0.3.2 2013-04-26
+#### v0.3.16 2013-05-14
 
-- [cc56df8](https://github.com/appium/ruby_lib/commit/cc56df88825ac8e705e740eed7ac8ca42bcc9dd0) Release 0.3.15
-- [8613403](https://github.com/appium/ruby_lib/commit/8613403db07435908a149dc296fb92cad8af2e35) Use boolean for .visible on iOS
-- [59980db](https://github.com/appium/ruby_lib/commit/59980db949a3a8c18d8441a369e6ef566df3ccae) Update release notes
-- [12aa291](https://github.com/appium/ruby_lib/commit/12aa29132a9a88076fbf8c76fbb65b1aa5e1fc96) Release 0.3.14
-- [a61b297](https://github.com/appium/ruby_lib/commit/a61b297d387b0c28865b050eaa3d7d59efae2a34) Add .visible for iOS
-- [6f6dda5](https://github.com/appium/ruby_lib/commit/6f6dda53fb12a483a524370c3d3c729fa1b87be4) Update gemspec
-- [baee435](https://github.com/appium/ruby_lib/commit/baee435d81a94f0bac51a15507e6eb8204c8885e) Update release notes
-- [7badb99](https://github.com/appium/ruby_lib/commit/7badb998734ee4c4ae0781c5e8f3cfc4b862eeb3) Release 0.3.13
-- [efaa0ea](https://github.com/appium/ruby_lib/commit/efaa0eaebe5a045dba8370ec98aea8bdf31637ba) Fix #52
-- [fd0941c](https://github.com/appium/ruby_lib/commit/fd0941cd02dbfeff32e506dcff8192480e13fb38) Update release notes
-- [faf3e98](https://github.com/appium/ruby_lib/commit/faf3e98d0d745df9bbbfada93dcfd6b47a585793) Release 0.3.12
-- [7ff6b95](https://github.com/appium/ruby_lib/commit/7ff6b955cafc235a554d192cc09014c4400dc27a) Add scroll_to
-- [d590b4d](https://github.com/appium/ruby_lib/commit/d590b4da6eab2da4068292ff6604afa89e73017e) Update release notes
-- [14d705a](https://github.com/appium/ruby_lib/commit/14d705acd527f13e2962e2c04200b6d28fd36cbb) Release 0.3.11
-- [ebdae44](https://github.com/appium/ruby_lib/commit/ebdae448b108c76e586ad8f8ae86a1abc495e7e5) Search name and text when using textfield
-- [e549984](https://github.com/appium/ruby_lib/commit/e549984b871819ce67ff6948e32a870574b7b4d2) Update release notes
-- [db557df](https://github.com/appium/ruby_lib/commit/db557df9939fa44f2a6bf5d8afd950a2fa4b4178) Release 0.3.10
-- [c3adbc5](https://github.com/appium/ruby_lib/commit/c3adbc52f0b049e6b9292ac2ff328160d1820668) Fix name and textfield
-- [5c26137](https://github.com/appium/ruby_lib/commit/5c261370fd68f363f0ab2f4d70ad486c43dc46fb) Android can't get alert text
-- [36f68de](https://github.com/appium/ruby_lib/commit/36f68de51954de79754e8f377f4a6dad47361dc1) Add shown attribute to Selendroid page
-- [4551ffe](https://github.com/appium/ruby_lib/commit/4551ffe0aa50bb63b0cff24b0a69c9c1c8a19529) Update release notes
-- [3b4fbb4](https://github.com/appium/ruby_lib/commit/3b4fbb4e6957a92ac4236d5666d932ee9da238e7) Release 0.3.9
-- [98b1b1e](https://github.com/appium/ruby_lib/commit/98b1b1e8e0952244c1ca2c8738d7d33af7eb0f68) Fix extra slashes in path
-- [4c43359](https://github.com/appium/ruby_lib/commit/4c433597c4409ab7c89e395297d2a6af3c6c439d) Update release notes
-- [e7bc45f](https://github.com/appium/ruby_lib/commit/e7bc45fd88f026dc51237d767da9f9dfa2e05b56) Release 0.3.8
-- [dc3a50f](https://github.com/appium/ruby_lib/commit/dc3a50f23ca6ba4978ddb9af1dadf6c6015eb9fb) Use 4.2 not 4.1
-- [f8042f1](https://github.com/appium/ruby_lib/commit/f8042f158f046815238463a9ea86cd66ea725942) Fix page Selendroid
-- [f9866e0](https://github.com/appium/ruby_lib/commit/f9866e034ea9a3744387fb15d5ca3ba221f27429) Load touch methods
-- [c3f9a2b](https://github.com/appium/ruby_lib/commit/c3f9a2b0300ee238acf4ce750f9b651ff39eb919) Don't set timeout on Selendroid until it's fixed
-- [d88245e](https://github.com/appium/ruby_lib/commit/d88245efe8fed5927e136719a9747b788dbd0fc2) Add page for Selendroid
-- [ff63433](https://github.com/appium/ruby_lib/commit/ff63433db6d68170ef135e151d6ac154c3504f4f) Add id method
-- [c59f7ce](https://github.com/appium/ruby_lib/commit/c59f7cefc76a9f172e6e6494aca275b5687d1a74) Improve debugging
-- [873bed9](https://github.com/appium/ruby_lib/commit/873bed9c3d30d0c4a64a497c9636c53275ab943f) Update release notes
-- [edfd20a](https://github.com/appium/ruby_lib/commit/edfd20a6ffdef8484b9f7b5eddb9c21815241d42) Release 0.3.7
-- [9f8511c](https://github.com/appium/ruby_lib/commit/9f8511c1416867df606dfb3d058f83ee277ce39a) Remove puts
-- [366da1f](https://github.com/appium/ruby_lib/commit/366da1f6e3c0621d55920bce244fc5aedd678e7d) Update release notes
-- [67e5c86](https://github.com/appium/ruby_lib/commit/67e5c867d38251687dc7ebd5de013db5712fcac3) Release 0.3.6
-- [a0a46f7](https://github.com/appium/ruby_lib/commit/a0a46f773a57c9ef7b92252afed467bd7cd01b96) Fix wait and add wait_true
-- [e7cde77](https://github.com/appium/ruby_lib/commit/e7cde775473bd3981cac5b356f78289f832091a9) Add wait example
-- [68a2fdd](https://github.com/appium/ruby_lib/commit/68a2fdde6851f8b24b953a380073b4957f128f06) Update release notes
-- [a886ef4](https://github.com/appium/ruby_lib/commit/a886ef4722a902fdef15ecfc7164299399f1d524) Release 0.3.5
-- [193eb71](https://github.com/appium/ruby_lib/commit/193eb716023f52506cdf599cff6aae4f4a3c1119) Fix JSON.parse
-- [54ba323](https://github.com/appium/ruby_lib/commit/54ba323721a704d3ceb34f71dd8e1fcf9069dd78) Use upstream get name contains
-- [6f66b46](https://github.com/appium/ruby_lib/commit/6f66b46725ee397cc437901e95431ec95935d9c2) Name contains moved upstream
-- [2d33b5c](https://github.com/appium/ruby_lib/commit/2d33b5ce4078d784f7f6f0ac07651166a466b34c) Update readme.md
-- [4a1f87e](https://github.com/appium/ruby_lib/commit/4a1f87e1f0524595d7bd15027b4a009a42b5ff83) Update example
-- [6177c49](https://github.com/appium/ruby_lib/commit/6177c497f9c114203e624f530e51f4f54a61788a) Rename get_wait
-- [e33f8fb](https://github.com/appium/ruby_lib/commit/e33f8fb96a97c30d765fe8b98288493b51dcb41c) Update release notes
-- [ffdf104](https://github.com/appium/ruby_lib/commit/ffdf104ffdecb165cfe410976145134768756e30) Release 0.3.4
-- [4edc9f6](https://github.com/appium/ruby_lib/commit/4edc9f6097e29d2816dceef546a819fd6ee431d2) Add params to wait
-- [da1c042](https://github.com/appium/ruby_lib/commit/da1c0424873fa5f859b1ec558356a3ad0721097b) Add selendroid launch support
-- [f398041](https://github.com/appium/ruby_lib/commit/f398041369884d8068950ab9e703a8a2d750082c) Use symbols for driver opts
-- [cf09a0d](https://github.com/appium/ruby_lib/commit/cf09a0d1ca8de835043f855cbd74ced9abb5f1b0) Add expected server opts
-- [fe6c7d7](https://github.com/appium/ruby_lib/commit/fe6c7d71dbaf7f7b383d117918de2498945406d4) Fix os specific patches
-- [d9b9c1a](https://github.com/appium/ruby_lib/commit/d9b9c1a2fcc1857e0e7c78d250fd59b84726d69b) Improve logging
-- [3b831b0](https://github.com/appium/ruby_lib/commit/3b831b089e02c4a53585d90ed009f5ad3cb982a7) Return invisible match if no visible result
-- [cdb11b6](https://github.com/appium/ruby_lib/commit/cdb11b6facde318af2524499c6473ea736865dde) Update release notes
-- [b0ca37c](https://github.com/appium/ruby_lib/commit/b0ca37cfe47318f029e1f2ad498a5c08338016d7) Release 0.3.3
-- [e7f55d9](https://github.com/appium/ruby_lib/commit/e7f55d92181660ea188a5123e6e4f447389c8d6d) Add driver method
-- [6d381fe](https://github.com/appium/ruby_lib/commit/6d381fe029bd9a5c11aa4d1a322d6afb603c6434) Update readme.md
-- [07da208](https://github.com/appium/ruby_lib/commit/07da208973ea4de64ec9605ef5dd38884771e8c6) Add troubleshooting steps
-- [7df8ddc](https://github.com/appium/ruby_lib/commit/7df8ddcd0edb294abaddd2424f0f6b45f086fb53) Update release notes
+- [fb34a03](https://github.com/appium/ruby_lib/commit/fb34a03ceec0be552f218323bf266fda7f7e060b) Release 0.3.16
+- [6e552ae](https://github.com/appium/ruby_lib/commit/6e552ae0d9a66a03ac50caa38f73f3f3dbded317) Selendroid is boolean
 
 
 #### v0.3.15 2013-05-13
 
 - [cc56df8](https://github.com/appium/ruby_lib/commit/cc56df88825ac8e705e740eed7ac8ca42bcc9dd0) Release 0.3.15
 - [8613403](https://github.com/appium/ruby_lib/commit/8613403db07435908a149dc296fb92cad8af2e35) Use boolean for .visible on iOS
-- [59980db](https://github.com/appium/ruby_lib/commit/59980db949a3a8c18d8441a369e6ef566df3ccae) Update release notes
 
 
 #### v0.3.14 2013-05-13
@@ -145,28 +15,24 @@
 - [12aa291](https://github.com/appium/ruby_lib/commit/12aa29132a9a88076fbf8c76fbb65b1aa5e1fc96) Release 0.3.14
 - [a61b297](https://github.com/appium/ruby_lib/commit/a61b297d387b0c28865b050eaa3d7d59efae2a34) Add .visible for iOS
 - [6f6dda5](https://github.com/appium/ruby_lib/commit/6f6dda53fb12a483a524370c3d3c729fa1b87be4) Update gemspec
-- [baee435](https://github.com/appium/ruby_lib/commit/baee435d81a94f0bac51a15507e6eb8204c8885e) Update release notes
 
 
 #### v0.3.13 2013-05-10
 
 - [7badb99](https://github.com/appium/ruby_lib/commit/7badb998734ee4c4ae0781c5e8f3cfc4b862eeb3) Release 0.3.13
 - [efaa0ea](https://github.com/appium/ruby_lib/commit/efaa0eaebe5a045dba8370ec98aea8bdf31637ba) Fix #52
-- [fd0941c](https://github.com/appium/ruby_lib/commit/fd0941cd02dbfeff32e506dcff8192480e13fb38) Update release notes
 
 
 #### v0.3.12 2013-05-10
 
 - [faf3e98](https://github.com/appium/ruby_lib/commit/faf3e98d0d745df9bbbfada93dcfd6b47a585793) Release 0.3.12
 - [7ff6b95](https://github.com/appium/ruby_lib/commit/7ff6b955cafc235a554d192cc09014c4400dc27a) Add scroll_to
-- [d590b4d](https://github.com/appium/ruby_lib/commit/d590b4da6eab2da4068292ff6604afa89e73017e) Update release notes
 
 
 #### v0.3.11 2013-05-09
 
 - [14d705a](https://github.com/appium/ruby_lib/commit/14d705acd527f13e2962e2c04200b6d28fd36cbb) Release 0.3.11
 - [ebdae44](https://github.com/appium/ruby_lib/commit/ebdae448b108c76e586ad8f8ae86a1abc495e7e5) Search name and text when using textfield
-- [e549984](https://github.com/appium/ruby_lib/commit/e549984b871819ce67ff6948e32a870574b7b4d2) Update release notes
 
 
 #### v0.3.10 2013-05-07
@@ -175,10 +41,16 @@
 - [c3adbc5](https://github.com/appium/ruby_lib/commit/c3adbc52f0b049e6b9292ac2ff328160d1820668) Fix name and textfield
 - [5c26137](https://github.com/appium/ruby_lib/commit/5c261370fd68f363f0ab2f4d70ad486c43dc46fb) Android can't get alert text
 - [36f68de](https://github.com/appium/ruby_lib/commit/36f68de51954de79754e8f377f4a6dad47361dc1) Add shown attribute to Selendroid page
-- [4551ffe](https://github.com/appium/ruby_lib/commit/4551ffe0aa50bb63b0cff24b0a69c9c1c8a19529) Update release notes
+
+
+#### v0.3.9 2013-05-06
+
 - [3b4fbb4](https://github.com/appium/ruby_lib/commit/3b4fbb4e6957a92ac4236d5666d932ee9da238e7) Release 0.3.9
 - [98b1b1e](https://github.com/appium/ruby_lib/commit/98b1b1e8e0952244c1ca2c8738d7d33af7eb0f68) Fix extra slashes in path
-- [4c43359](https://github.com/appium/ruby_lib/commit/4c433597c4409ab7c89e395297d2a6af3c6c439d) Update release notes
+
+
+#### v0.3.8 2013-05-06
+
 - [e7bc45f](https://github.com/appium/ruby_lib/commit/e7bc45fd88f026dc51237d767da9f9dfa2e05b56) Release 0.3.8
 - [dc3a50f](https://github.com/appium/ruby_lib/commit/dc3a50f23ca6ba4978ddb9af1dadf6c6015eb9fb) Use 4.2 not 4.1
 - [f8042f1](https://github.com/appium/ruby_lib/commit/f8042f158f046815238463a9ea86cd66ea725942) Fix page Selendroid
@@ -187,14 +59,23 @@
 - [d88245e](https://github.com/appium/ruby_lib/commit/d88245efe8fed5927e136719a9747b788dbd0fc2) Add page for Selendroid
 - [ff63433](https://github.com/appium/ruby_lib/commit/ff63433db6d68170ef135e151d6ac154c3504f4f) Add id method
 - [c59f7ce](https://github.com/appium/ruby_lib/commit/c59f7cefc76a9f172e6e6494aca275b5687d1a74) Improve debugging
-- [873bed9](https://github.com/appium/ruby_lib/commit/873bed9c3d30d0c4a64a497c9636c53275ab943f) Update release notes
+
+
+#### v0.3.7 2013-05-01
+
 - [edfd20a](https://github.com/appium/ruby_lib/commit/edfd20a6ffdef8484b9f7b5eddb9c21815241d42) Release 0.3.7
 - [9f8511c](https://github.com/appium/ruby_lib/commit/9f8511c1416867df606dfb3d058f83ee277ce39a) Remove puts
-- [366da1f](https://github.com/appium/ruby_lib/commit/366da1f6e3c0621d55920bce244fc5aedd678e7d) Update release notes
+
+
+#### v0.3.6 2013-05-01
+
 - [67e5c86](https://github.com/appium/ruby_lib/commit/67e5c867d38251687dc7ebd5de013db5712fcac3) Release 0.3.6
 - [a0a46f7](https://github.com/appium/ruby_lib/commit/a0a46f773a57c9ef7b92252afed467bd7cd01b96) Fix wait and add wait_true
 - [e7cde77](https://github.com/appium/ruby_lib/commit/e7cde775473bd3981cac5b356f78289f832091a9) Add wait example
-- [68a2fdd](https://github.com/appium/ruby_lib/commit/68a2fdde6851f8b24b953a380073b4957f128f06) Update release notes
+
+
+#### v0.3.5 2013-04-30
+
 - [a886ef4](https://github.com/appium/ruby_lib/commit/a886ef4722a902fdef15ecfc7164299399f1d524) Release 0.3.5
 - [193eb71](https://github.com/appium/ruby_lib/commit/193eb716023f52506cdf599cff6aae4f4a3c1119) Fix JSON.parse
 - [54ba323](https://github.com/appium/ruby_lib/commit/54ba323721a704d3ceb34f71dd8e1fcf9069dd78) Use upstream get name contains
@@ -202,7 +83,10 @@
 - [2d33b5c](https://github.com/appium/ruby_lib/commit/2d33b5ce4078d784f7f6f0ac07651166a466b34c) Update readme.md
 - [4a1f87e](https://github.com/appium/ruby_lib/commit/4a1f87e1f0524595d7bd15027b4a009a42b5ff83) Update example
 - [6177c49](https://github.com/appium/ruby_lib/commit/6177c497f9c114203e624f530e51f4f54a61788a) Rename get_wait
-- [e33f8fb](https://github.com/appium/ruby_lib/commit/e33f8fb96a97c30d765fe8b98288493b51dcb41c) Update release notes
+
+
+#### v0.3.4 2013-04-30
+
 - [ffdf104](https://github.com/appium/ruby_lib/commit/ffdf104ffdecb165cfe410976145134768756e30) Release 0.3.4
 - [4edc9f6](https://github.com/appium/ruby_lib/commit/4edc9f6097e29d2816dceef546a819fd6ee431d2) Add params to wait
 - [da1c042](https://github.com/appium/ruby_lib/commit/da1c0424873fa5f859b1ec558356a3ad0721097b) Add selendroid launch support
@@ -211,19 +95,24 @@
 - [fe6c7d7](https://github.com/appium/ruby_lib/commit/fe6c7d71dbaf7f7b383d117918de2498945406d4) Fix os specific patches
 - [d9b9c1a](https://github.com/appium/ruby_lib/commit/d9b9c1a2fcc1857e0e7c78d250fd59b84726d69b) Improve logging
 - [3b831b0](https://github.com/appium/ruby_lib/commit/3b831b089e02c4a53585d90ed009f5ad3cb982a7) Return invisible match if no visible result
-- [cdb11b6](https://github.com/appium/ruby_lib/commit/cdb11b6facde318af2524499c6473ea736865dde) Update release notes
+
+
+#### v0.3.3 2013-04-27
+
 - [b0ca37c](https://github.com/appium/ruby_lib/commit/b0ca37cfe47318f029e1f2ad498a5c08338016d7) Release 0.3.3
 - [e7f55d9](https://github.com/appium/ruby_lib/commit/e7f55d92181660ea188a5123e6e4f447389c8d6d) Add driver method
 - [6d381fe](https://github.com/appium/ruby_lib/commit/6d381fe029bd9a5c11aa4d1a322d6afb603c6434) Update readme.md
 - [07da208](https://github.com/appium/ruby_lib/commit/07da208973ea4de64ec9605ef5dd38884771e8c6) Add troubleshooting steps
-- [7df8ddc](https://github.com/appium/ruby_lib/commit/7df8ddcd0edb294abaddd2424f0f6b45f086fb53) Update release notes
+
+
+#### v0.3.2 2013-04-26
+
 - [eee6632](https://github.com/appium/ruby_lib/commit/eee6632251c40c8b2d6be9a361f429d7c89762f8) Release 0.3.2
 - [b22d747](https://github.com/appium/ruby_lib/commit/b22d7473f03e1b13a1ffd9ddc2ea5ca1396c4642) Default to app_activity if app_wait_activity is not set
 - [76198ad](https://github.com/appium/ruby_lib/commit/76198ad4d169d836007a247b2ebe8cad5391f512) Fix reset clearing iOS JavaScript
 - [445519b](https://github.com/appium/ruby_lib/commit/445519b4528c9c253865f76fdac921a22c31fbd7) Use Appium's detailed error messages
 - [e00964f](https://github.com/appium/ruby_lib/commit/e00964fa7b9ccd047b06f1432ddd1e62170306df) Update readme.md
 - [ef0b626](https://github.com/appium/ruby_lib/commit/ef0b626940d86fd07dbb86ac16b40dd5b0b5ce4a) Avoid invisible elements
-- [7278574](https://github.com/appium/ruby_lib/commit/727857450f0d2fc29ef53bbe4f5536619eedb250) Update release notes
 
 
 #### v0.3.1 2013-04-26
@@ -234,7 +123,6 @@
 - [fa8b679](https://github.com/appium/ruby_lib/commit/fa8b679b816bd1507c7c9de3f301a3b8a7742d8f) Fix iOS name
 - [5be26c4](https://github.com/appium/ruby_lib/commit/5be26c411fcf75154301749cd790487d3dd71ea9) Add sauce methods and find_name
 - [b3724d3](https://github.com/appium/ruby_lib/commit/b3724d36a85188c7c8c85dadc313c6c43c8bed59) Add session_id
-- [433de96](https://github.com/appium/ruby_lib/commit/433de96d25907841fbc9110d79ad0c1fa6eacf73) Update release notes
 
 
 #### v0.3.0 2013-04-25
@@ -271,7 +159,6 @@
 - [763d086](https://github.com/appium/ruby_lib/commit/763d0862135bf9e06ad177c9e3e20a83819b1775) Use mobile method
 - [09035ab](https://github.com/appium/ruby_lib/commit/09035ab053df980baf43b8d1128f68fe52df37a4) Remove old comment
 - [2d07ed0](https://github.com/appium/ruby_lib/commit/2d07ed0d5868c734168b31fb47881eaa4c74af1c) Raise instead of puts
-- [d904c0f](https://github.com/appium/ruby_lib/commit/d904c0f83cc6212f7682c3d15123f5db9a380312) Update release notes
 
 
 #### v0.0.30 2013-04-16
@@ -279,7 +166,6 @@
 - [6d65a9c](https://github.com/appium/ruby_lib/commit/6d65a9c2895b1b66556b12fee4fc9649f558ede1) Release 0.0.30
 - [5692f96](https://github.com/appium/ruby_lib/commit/5692f9604a09b6198f8ada7823d8f74858b8af88) Fix quote
 - [ee17332](https://github.com/appium/ruby_lib/commit/ee173329758ea486d32d6887439de39a749ceba0) Use driver_quit
-- [5a71419](https://github.com/appium/ruby_lib/commit/5a71419c931ab19f8ab2816e1e5ee35ff457b2a0) Update release notes
 
 
 #### v0.0.29 2013-04-15
@@ -289,7 +175,6 @@
 - [f5f82c0](https://github.com/appium/ruby_lib/commit/f5f82c0f98291e0f8b8ae0baa6285ad4b62cc34e) Default to partial match
 - [2e7f8c6](https://github.com/appium/ruby_lib/commit/2e7f8c6b09aa433d3712685f6842a052dd4847b3) Update webdriver
 - [b7b6caa](https://github.com/appium/ruby_lib/commit/b7b6caa8ab0c2683626aed265ee6ec2feece37f0) Use gh_name
-- [6562cd6](https://github.com/appium/ruby_lib/commit/6562cd64734888c761c0373fd866e8c15b2ddf8e) Update release notes
 
 
 #### v0.0.28 2013-04-11
@@ -317,7 +202,6 @@
 - [fb4af20](https://github.com/appium/ruby_lib/commit/fb4af206c114cf8f75fcb41cdbbea0ba728bf7e6) Release 0.0.27
 - [ca00d82](https://github.com/appium/ruby_lib/commit/ca00d82fb8e716d5941ec0ee6b38b207329b915e) Fix require
 - [ad00639](https://github.com/appium/ruby_lib/commit/ad006393ce8b6dc071c98b2edf73c32707d37762) Update readme.md
-- [80027ba](https://github.com/appium/ruby_lib/commit/80027ba6caca5d79345a9abf8cf1b8b9573fad9d) Update release notes
 
 
 #### v0.0.26 2013-04-04