appium_lib 0.12.0 → 0.13.0

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

@@ -91,15 +91,38 @@ the first element that matches.
     mobile :find, [ [ [7, name] ] ]
   end
 
+  # Return the first element exactly matching name.
+  # on Android name is content description
+  # on iOS name is the accessibility label or the text.
+  # @param name [String] the name to search for
+  # @return [Element] the first matching element
+  def name_exact name
+    # exact description
+    result = mobile :find, [ [ [5, name] ] ]
+
+    return result if result.kind_of? Selenium::WebDriver::Element
+
+    if result.length > 0
+      result.first
+    else
+      Appium::Common.raise_no_element_error
+    end
+  end
+
   # Return all elements matching name.
   # on Android name is content description
   # on iOS name is the accessibility label or the text.
   # @param name [String] the name to search for
   # @return [Array<Element>] all matching elements
-  def names name
-    args = 'all',
-           [ [7, name] ]
-    mobile :find, args
+  def names name=''
+    if name.nil? || name.empty?
+      args = 'all', [ [7, ''], [100] ]
+      mobile :find, args
+    else
+      args = 'all',
+          [ [7, name] ]
+      mobile :find, args
+    end
   end
 
   # Scroll to an element containing target text or description.
@@ -114,4 +137,17 @@ the first element that matches.
 
     mobile :find, args
   end
+
+  # Scroll to an element with the exact target text or description.
+  # @param text [String] the text to search for in the text value and content description
+  # @return [Element] the element scrolled to
+  def scroll_to_exact text
+    args = 'scroll',
+        # text(text)
+        [ [1, text] ],
+        # description(text)
+        [ [5, text] ]
+
+    mobile :find, args
+  end
 end # module Appium::Android

data/lib/appium_lib/common/helper.rb

@@ -227,6 +227,14 @@ module Appium::Common
     find_element :tag_name, tag_name
   end
 
+  # Returns all elements matching tag_name
+  #
+  # @param tag_name [String] the tag_name to search for
+  # @return [Element]
+  def tags tag_name
+    find_elements :tag_name, tag_name
+  end
+
   # Converts pixel values to window relative values
   #
   # ```ruby

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.12.0' unless defined? ::Appium::VERSION
-  DATE = '2013-11-07' unless defined? ::Appium::DATE
+  VERSION = '0.13.0' unless defined? ::Appium::VERSION
+  DATE = '2013-11-22' unless defined? ::Appium::DATE
 end

data/lib/appium_lib/driver.rb

@@ -375,7 +375,8 @@ module Appium
         name: @app_name || 'Ruby Console Android Appium',
         :'app-package' => @app_package,
         :'app-activity' => @app_activity,
-        :'app-wait-activity' => @app_wait_activity || @app_activity
+        :'app-wait-activity' => @app_wait_activity || @app_activity,
+        fastClear: false # use adb uninstall/pm install not pm clear
       }
     end
 

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

@@ -118,6 +118,19 @@ module Appium::Ios
     mobile :findElementNameContains, name: name
   end
 
+  def name_exact name
+    js = all_ele_js "name == '#{name}'"
+    result = execute_script js
+
+    return result if result.kind_of? Selenium::WebDriver::Element
+
+    if result.length > 0
+      result.first
+    else
+      Appium::Common.raise_no_element_error
+    end
+  end
+
   # Return all elements matching name.
   # on Android name is content description
   # on iOS name is the accessibility label or the text.

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

@@ -64,4 +64,14 @@ module Appium::Ios
   def textfield_exact text
     xpath "textfield[@text='#{text}']"
   end
+
+  # Get the first textfield that exactly matches name
+  # @return [Element]
+  def textfield_named target_name
+    wait do
+      target = e_textfields.detect { |e| e.name == target_name }
+      raise "Textfield named #{target_name} not found" unless target
+      target
+    end
+  end
 end # module Appium::Ios

data/lib/appium_lib/ios/helper.rb

@@ -47,7 +47,7 @@ module Appium::Ios
   # Password character returned from value of UIASecureTextField
   # @param length [Integer] the length of the password to generate
   # @return [String] the returned string is of size length
-  def password length=1
+  def ios_password length=1
     '•' * length
   end
 
@@ -192,4 +192,11 @@ module Appium::Ios
     raise "Invalid id `#{id}`" unless @strings_xml[id]
     find_element :id, id
   end
+
+  # Return the iOS version as an array of integers
+  # @return [Array<Integer>]
+  def ios_version
+    ios_version = execute_script 'UIATarget.localTarget().systemVersion()'
+    ios_version.split('.').map { |e| e.to_i }
+  end
 end # module Appium::Ios

data/release_notes.md

@@ -1,3 +1,27 @@
+#### v0.13.0 2013-11-22
+
+- [647cb94](https://github.com/appium/ruby_lib/commit/647cb942f344c635e067f2ae563f4fae12685148) Release 0.13.0
+- [a235a2c](https://github.com/appium/ruby_lib/commit/a235a2c70d2c7dc1934c9fb403fb95cc3ae56e04) Update name_exact
+- [f1d2701](https://github.com/appium/ruby_lib/commit/f1d270120ae248beb6746a0149ebcbe4e34ebcca) names on Android will return the text values when no arg is passed
+- [7ac38c9](https://github.com/appium/ruby_lib/commit/7ac38c97b99178f6ae0bf8f7b5474a0cd3379e87) Fix return value of name_exact
+- [e6da4aa](https://github.com/appium/ruby_lib/commit/e6da4aa4937bfdc6f094f7895ecf172f8b96f32a) Add textfield_named for iOS
+- [789fc52](https://github.com/appium/ruby_lib/commit/789fc5276ad000dafd5a400f3d9aa8cfcd37e17d) Add ios_version method
+- [5447f4c](https://github.com/appium/ruby_lib/commit/5447f4cf3645459ddb4335b4a242b7639fc860f8) Rename password to ios_password
+- [a5b85de](https://github.com/appium/ruby_lib/commit/a5b85de11e413e301f94d41689658b01342bb1c8) Add scroll_to_exact for Android & more
+- [cc7e778](https://github.com/appium/ruby_lib/commit/cc7e778fd1532e5e15ea9933a300189ce8dc9e8a) Default to fastClear: false
+- [f54f145](https://github.com/appium/ruby_lib/commit/f54f14551e04517c71d9177fc0bd72797cd77781) Add link to minitest expectations
+
+
+#### v0.12.0 2013-11-07
+
+- [c92bd37](https://github.com/appium/ruby_lib/commit/c92bd3710be09731aa8ba4547a3e19af9eeaceab) Release 0.12.0
+- [f1b7633](https://github.com/appium/ruby_lib/commit/f1b7633e5dcfcd6d0d21f003ce0d98de1d093a13) Add s_texts_names. Fix alert_dismiss_text and alert_accept_text for iOS 7
+- [6f2d698](https://github.com/appium/ruby_lib/commit/6f2d6981b1f12443c4079dba455b16d1f331f903) Fix page on iOS 7
+- [70dbac3](https://github.com/appium/ruby_lib/commit/70dbac321688dfbec1d5f0a8efe6a7282678b88b) set_wait and no_wait now update @default_wait
+- [1f31754](https://github.com/appium/ruby_lib/commit/1f31754386dfd282e1143e3386ba18b1c656bb9d) Restore readme
+- [1e7a4c3](https://github.com/appium/ruby_lib/commit/1e7a4c36d1ea0df0ed87a2decbf8793406673774) Update Android page to always output resource-ids
+
+
 #### v0.11.1 2013-09-24
 
 - [0551d9a](https://github.com/appium/ruby_lib/commit/0551d9a4de2cb3d62efe63a87b01c15526202336) Release 0.11.1

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - code@bootstraponline.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-07 00:00:00.000000000 Z
+date: 2013-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -138,7 +138,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.9
+rubygems_version: 2.1.11
 signing_key: 
 specification_version: 4
 summary: Ruby library for Appium