appium_lib 0.0.30 → 0.3.0

data/release_notes.md

@@ -1,3 +1,11 @@
+#### v0.0.30 2013-04-16
+
+- [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
 
 - [1c1e0ee](https://github.com/appium/ruby_lib/commit/1c1e0eeed8d636dc81d3b74612405722b1134071) Release 0.0.29

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 0.0.30
+  version: 0.3.0
 platform: ruby
 authors:
 - code@bootstraponline.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-16 00:00:00.000000000 Z
+date: 2013-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -66,19 +66,23 @@ files:
 - appium_lib.gemspec
 - docs.md
 - lib/appium_lib.rb
-- lib/appium_lib/console.rb
-- lib/appium_lib/element/android/alert.rb
-- lib/appium_lib/element/android/generic.rb
-- lib/appium_lib/element/android/textfield.rb
-- lib/appium_lib/element/button.rb
-- lib/appium_lib/element/ios/alert.rb
-- lib/appium_lib/element/ios/generic.rb
-- lib/appium_lib/element/ios/textfield.rb
-- lib/appium_lib/element/text.rb
-- lib/appium_lib/element/window.rb
-- lib/appium_lib/helper.rb
-- lib/appium_lib/patch.rb
-- lib/appium_lib/version.rb
+- lib/appium_lib/android/element/alert.rb
+- lib/appium_lib/android/element/generic.rb
+- lib/appium_lib/android/element/textfield.rb
+- lib/appium_lib/android/helper.rb
+- lib/appium_lib/android/patch.rb
+- lib/appium_lib/common/element/button.rb
+- lib/appium_lib/common/element/text.rb
+- lib/appium_lib/common/element/window.rb
+- lib/appium_lib/common/helper.rb
+- lib/appium_lib/common/patch.rb
+- lib/appium_lib/common/version.rb
+- lib/appium_lib/driver.rb
+- lib/appium_lib/ios/element/alert.rb
+- lib/appium_lib/ios/element/generic.rb
+- lib/appium_lib/ios/element/textfield.rb
+- lib/appium_lib/ios/helper.rb
+- lib/appium_lib/ios/patch.rb
 - readme.md
 - release_notes.md
 homepage: https://github.com/appium/ruby_lib

data/lib/appium_lib/console.rb

@@ -1,254 +0,0 @@
-# encoding: utf-8
-=begin
-Run with:
-pry -r ./console.rb
-
-Based on simple_test.rb
-https://github.com/appium/appium/blob/82995f47408530c80c3376f4e07a1f649d96ba22/sample-code/examples/ruby/simple_test.rb
-https://github.com/appium/appium/blob/c58eeb66f2d6fa3b9a89d188a2e657cca7cb300f/LICENSE
-=end
-
-add_to_path __FILE__
-add_to_path __FILE__, 'element'
-
-require 'selenium-webdriver'
-
-# Path to the .app or .app.zip.
-# The path can be local or remote for Sauce.
-APP_PATH = ENV['APP_PATH'] unless defined?(APP_PATH)
-raise "APP_PATH must be set." if APP_PATH.nil?
-
-# The name to use for the test run on Sauce.
-APP_NAME = ENV['APP_NAME'] unless defined?(APP_NAME)
-
-# Android app package
-APP_PACKAGE = ENV['APP_PACKAGE'] unless defined?(APP_PACKAGE)
-
-# Android app starting activity.
-APP_ACTIVITY = ENV['APP_ACTIVITY'] unless defined?(APP_ACTIVITY)
-
-# Android app waiting activity
-APP_WAIT_ACTIVITY = ENV['APP_WAIT_ACTIVITY'] unless defined?(APP_WAIT_ACTIVITY)
-
-# Sauce Username
-SAUCE_USERNAME = ENV['SAUCE_USERNAME'] unless defined?(SAUCE_USERNAME)
-
-# Sauce Key
-SAUCE_ACCESS_KEY = ENV['SAUCE_ACCESS_KEY'] unless defined?(SAUCE_ACCESS_KEY)
-
-PORT = ENV['PORT'] || 4723 unless defined?(PORT)
-
-$os = nil
-
-if $os.nil?
-  $os = :ios
-  $os = :android if APP_PATH.end_with?('.apk') || APP_PATH.end_with?('.apk.zip')
-end
-
-puts "OS is: #{$os}" if defined?(Pry)
-
-if $os == :android
-  raise "APP_PACKAGE must be set." if APP_PACKAGE.nil?
-  raise "APP_ACTIVITY must be set." if APP_ACTIVITY.nil?
-end
-
-# ruby_console files load depending on OS
-require 'helper'
-require 'button'
-require 'text'
-require 'window'
-require 'patch'
-
-# Android combines secure and textfield.
-# iOS differentiates between secure and textfield.
-# combine secure & textfield on iOS to match Android behavior.
-if $os == :ios
-  require 'ios/textfield'
-  require 'ios/alert'
-  require 'ios/generic'
-else
-  require 'android/textfield'
-  require 'android/alert'
-  require 'android/generic'
-end
-
-# WebDriver capabilities. Must be valid for Sauce to work.
-# https://github.com/jlipps/appium/blob/master/app/android.js
-def android_capabilities
-  {
-    browserName: 'Android',
-    platform: 'LINUX',
-    version: '4.1',
-    device: 'Android',
-    name: APP_NAME || 'Ruby Console Android Appium',
-    app: absolute_app_path,
-    :'app-package' => APP_PACKAGE,
-    :'app-activity' => APP_ACTIVITY,
-    :'app-wait-activity' => APP_WAIT_ACTIVITY
-  }
-end
-
-# WebDriver capabilities. Must be valid for Sauce to work.
-def ios_capabilities
-  {
-    browserName: 'iOS 6.0',
-    platform: 'Mac 10.8',
-    version: '6.0',
-    device: 'iPhone Simulator',
-    name: APP_NAME || 'Ruby Console iOS Appium',
-    app: absolute_app_path
-  }
-end
-
-def capabilities
-  $os == :ios ? ios_capabilities : android_capabilities
-end
-
-# Converts environment variable APP_PATH to an absolute path.
-# @return [String] APP_PATH as an absolute path
-def absolute_app_path
-    raise 'APP_PATH environment variable not set!' if APP_PATH.nil?
-    return APP_PATH if APP_PATH.match(/^http/) # public URL for Sauce
-    if APP_PATH.match(/^\//) # absolute file path
-      raise "App doesn't exist. #{APP_PATH}" unless File.exist? APP_PATH 
-      return APP_PATH
-    end
-    file = File.join(File.dirname(__FILE__), APP_PATH)
-    raise "App doesn't exist #{file}" unless File.exist? file
-    file
-end
-
-# Get the server url for sauce or local based on env vars.
-# @return [String] the server url
-def server_url
-  if !SAUCE_USERNAME.nil? && !SAUCE_ACCESS_KEY.nil?
-    "http://#{SAUCE_USERNAME}:#{SAUCE_ACCESS_KEY}@ondemand.saucelabs.com:80/wd/hub"
-  else
-    "http://127.0.0.1:#{PORT}/wd/hub"
-  end
-end
-
-# Quits the driver
-# @return [void]
-def driver_quit
-  # rescue NoSuchDriverError
-  begin; $driver.quit unless $driver.nil?; rescue; end
-end
-
-# Creates a new global driver and quits the old one if it exists.
-# @return [Selenium::WebDriver] the new global driver
-def start_driver wait=30
-  @client = @client || Selenium::WebDriver::Remote::Http::Default.new
-  @client.timeout = 999999
-
-  $default_wait = wait
-
-  # If the driver already exists, quit before creating a new driver.
-  driver_quit
-
-  begin
-    $driver = Selenium::WebDriver.for(:remote, http_client: @client, desired_capabilities: capabilities, url: server_url)
-  rescue Errno::ECONNREFUSED
-    puts 'ERROR: Unable to connect to Appium. Is the server running?'
-    exit
-  end
-
-  # Set timeout to a large number so that Appium doesn't quit
-  # when no commands are entered after 60 seconds.
-  $driver.execute_script 'mobile: setCommandTimeout', timeout: 9999
-
-  # Set implicit wait by default unless we're using Pry.
-  $driver.manage.timeouts.implicit_wait = $default_wait unless defined?(Pry)
-
-  $driver
-end
-
-# Set implicit wait to zero.
-def no_wait
-  $driver.manage.timeouts.implicit_wait = 0
-end
-
-# Set implicit wait to timeout, defaults to 30.
-# @param timeout [Integer] the timeout in seconds
-# @return [void]
-def set_wait timeout=$default_wait
-  $driver.manage.timeouts.implicit_wait = timeout
-end
-
-# Returns the default client side wait.
-# This value is independent of what the server is using
-# @return [Integer]
-def get_wait
-  $default_wait
-end
-
-# Returns existance of element.
-#
-# Example:
-#
-# exists { button('sign in') } ? puts('true') : puts('false')
-#
-# @return [Boolean]
-def exists &search_block
-  pre_check = 0
-  post_check = $default_wait
-
-  set_wait pre_check # set wait to zero
-
-  # the element exists unless an error is raised.
-  exists = true
-
-  begin
-    search_block.call # search for element
-  rescue
-    exists = false # error means it's not there
-  end
-
-  # restore wait
-  set_wait post_check
-
-  return exists
-end
-
-# The same as $driver.execute_script
-# @return [Object] the object returned by execute_script
-def execute_script script, *args
-  $driver.execute_script script, *args
-end
-
-# 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
-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
-  $driver.execute_script "mobile: #{method.to_s}", *args
-end
-
-# Calls $driver.find_elements
-def find_elements *args
-  $driver.find_elements *args
-end
-
-# Calls $driver.find_elements
-def find_element *args
-  $driver.find_element *args
-end
-
-# Quit the driver and Pry.
-# quit and exit are reserved by Pry.
-def x
-  driver_quit
-  exit # exit pry
-end
-
-# 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)

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

@@ -1,45 +0,0 @@
-# encoding: utf-8
-if $os == :android
-
-# Tap the alert button identified by value.
-# @param value [Integer, String] either an integer index of the button or the button's name
-# @return [void]
-def alert_click value
-  button(value).click
-end
-
-# Get the alert message text.
-# @return [String]
-def alert_text
-  get_page
-end
-
-# Accept the alert.
-# The last button is considered "accept."
-# @return [void]
-def alert_accept
-  last_button.click
-end
-
-# Get the text of the alert's accept button.
-# The last button is considered "accept."
-# @return [String]
-def alert_accept_text
-  last_button.text
-end
-
-# Dismiss the alert.
-# The first button is considered "dismiss."
-# @return [void]
-def alert_dismiss
-  first_button.click
-end
-
-# Get the text of the alert's dismiss button.
-# The first button is considered "dismiss."
-# @return [String]
-def alert_dismiss_text
-  first_button.text
-end
-
-end # if $os == :android

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

@@ -1,88 +0,0 @@
-# encoding: utf-8
-if $os == :android
-=begin
-name, names, text, text should match substring and case insensitive.
-
-In Android //* is used to find partial case insensitive text matches.
-//* is not currently implemented in iOS.
-
-find_element :name by default uses a partial case insensitive match.
-On iOS the default is an exact name match.
-=end
-
-=begin
-    // iOS version
-    // https://github.com/appium/ruby_lib/blob/37bb4e90b29e5adb4438b287b6387a504c94b5c4/lib/appium_lib/element/ios/generic.rb#L23
-    var search = "name contains[c] '#{text}' || label contains[c] '#{text}' || value contains[c] '#{text}'";
-    var a = w.secureTextFields().firstWithPredicate(search);
-    if ( isNil(a) ) {
-      a = w.textFields().firstWithPredicate(search);
-      if ( isNil(a) ) {
-        a = w.buttons().firstWithPredicate(search);
-        if ( isNil(a) ) {
-          a = w.elements().firstWithPredicate(search);
-        }
-      }
-    }
-
-Android considers both a textfield and a secure textfield to be "EditText".
-Name (the content desc) is searched first and then we search for value (text).
-There's no label in Android.
-
-Android buttons have different class names (android.widget.Button, android.widget.ImageButton)
-so we consider the element a button if the class name contains the word button.
-
-After looking for textfields and buttons, then we search all elements. Find will return
-the first element that matches.
-=end
-def find val
-  # s.className('android.widget.EditText').descriptionContains(value);
-  args = [ [4, 'android.widget.EditText'], [7, val] ],
-  # s.className('android.widget.EditText').textContains(value);
-         [ [4, 'android.widget.EditText'], [3, val] ],
-  # s.classNameMatches('(?i).*button.*').descriptionContains(value);
-         [ [26, '(?i).*button.*'], [7, val] ],
-  # s.classNameMatches('(?i).*button.*').textContains(value);
-         [ [26, '(?i).*button.*'], [3, val] ],
-  # s.descriptionContains(value);
-         [ [7, val] ],
-  # s.textContains(value);
-         [ [3, val] ]
-  mobile :find, args
-end
-
-# Return the first element matching text.
-# @param text [String] the text to search for
-# @return [Element] the first matching element
-def text text
-  # TODO: Use XPath index once it's implemented
-  # https://github.com/appium/appium/issues/295
-  texts(text).first
-end
-
-# Return all elements matching text.
-# @param text [String] the text to search for
-# @return [Array<Element>] all matching elements
-def texts text
-  $driver.find_elements :xpath, "//*[contains(@text, '#{text}')]"
-end
-
-# Return the first element 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 name
-  $driver.find_element :name, name
-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
-  $driver.find_elements :name, name
-end
-
-end # if $os == :android