appium_lib 0.0.30 → 0.3.0

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

@@ -1,44 +0,0 @@
-# encoding: utf-8
-if $os == :android
-# UIATextField methods
-
-# Get an array of textfield texts.
-# @return [Array<String>]
-def textfields
-  find_eles_attr :textfield, :text
-end
-
-# Get an array of textfield elements.
-# @return [Array<Textfield>]
-def e_textfields
-  find_eles :textfield
-end
-
-# Get the first textfield element.
-# @return [Textfield]
-def first_textfield
-  first_ele :textfield
-end
-
-# Get the last textfield element.
-# @return [Textfield]
-def last_textfield
-  last_ele :textfield
-end
-
-# Get the first textfield that matches text.
-# @param text [String, Integer] the text to match exactly. If int then the textfield at that index is returned.
-# @return [Textfield]
-def textfield text
-  return ele_index :textfield, text if text.is_a? Numeric
-  find_ele_by_text :textfield, text
-end
-
-# Get the first textfield that includes text.
-# @param text [String] the text the textfield must include
-# @return [Textfield]
-def textfield_include text
-  find_ele_by_text_include :textfield, text
-end
-
-end # if $os == :android

data/lib/appium_lib/element/button.rb

@@ -1,83 +0,0 @@
-# encoding: utf-8
-# UIAButton methods
-
-# Find a button by text and optionally number.
-# @param text [String, Integer] the text to exactly match. If int then the button at that index is returned.
-# @param number [Integer] the occurance of the button matching text. Defaults to the first button.
-# @return [Button] the button found with text and matching number
-def button text, number=0
-  # return button at index.
-  return ele_index :button, text if text.is_a? Numeric
-
-  number >= 1 ? button_num( text, number ) :
-                find_ele_by_text_include( :button, text )
-end
-
-# Get an array of button texts or button elements if text is provided.
-# @param text [String] the text to exactly match
-# @return [Array<String>, Array<Buttons>] either an array of button texts or an array of button elements if text is provided.
-def buttons text=nil
-  text == nil ? find_eles_attr( :button, :text ) :
-                find_eles_by_text_include( :button, text )
-end
-
-# Get the first button element.
-# @return [Button]
-def first_button
-  first_ele :button
-end
-
-# Get the last button element.
-# @return [Button]
-def last_button
-  last_ele :button
-end
-
-# Get the first button element that exactly matches text.
-# @param text [String] the text to match exactly
-# @return [Button]
-def button_exact text
-  find_ele_by_text :button, text
-end
-
-# Get all button elements that exactly match text.
-# @param text [String] the text to match exactly
-# @return [Array<Button>]
-def buttons_exact text
-  find_eles_by_text :button, text
-end
-
-# Get an array of button elements.
-# @return [Array<Button>]
-def e_buttons
-  find_eles :button
-end
-
-# 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.
-#
-# @param text [String] the text to match
-# @param number [Integer] the button occurance to return. 1 = first button
-# @return [Button] the button that matches text and number
-def button_num text, number=1
-  raise "Number must be >= 1" if number <= 0
-  number = number - 1 # zero indexed
-
-  result = nil
-
-  elements = buttons text
-  elements.size > number ? result = elements[number]
-                         : result = elements.first
-
-  result
-end

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

@@ -1,49 +0,0 @@
-# encoding: utf-8
-if $os == :ios
-# iOS only
-# 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
-  $driver.execute_script "UIATarget.localTarget().frontMostApp().alert().buttons()[#{value}].tap();"
-end
-
-# Get the alert message text.
-# @return [String]
-def alert_text
-  $driver.switch_to.alert.text
-end
-
-# Accept the alert.
-# @return [void]
-def alert_accept
-  $driver.switch_to.alert.accept
-end
-
-# Get the text of the alert's accept button.
-# The last button is considered "accept."
-# @return [String]
-def alert_accept_text
-  a = $driver.find_element(:tag_name, :alert)
-  return if a.nil?
-  b = a.find_elements(:tag_name, :button)
-  b.last.text if b && b.size >= 1
-end
-
-# Dismiss the alert.
-# @return [void]
-def alert_dismiss
-  $driver.switch_to.alert.dismiss
-end
-
-# Get the text of the alert's dismiss button.
-# The first button is considered "dismiss."
-# @return [String]
-def alert_dismiss_text
-  a = $driver.find_element(:tag_name, :alert)
-  return if a.nil?
-  b = a.find_elements(:tag_name, :button)
-  b.first.text if b && b.size >= 1
-end
-
-end # if $os == :ios

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

@@ -1,140 +0,0 @@
-# encoding: utf-8
-if $os == :ios
-=begin
-name, names, text, text should match substring and case insensitive.
-
-iOS .name() is the accessibility attribute. If not defined, then .label() is used instead.
-This differs from Android where name (the content description) is empty when not set.
-
-name defaults to label when undefined. value is never a default so that must be
-included in a new search.
-
-Find - search everything.
-
-The search order is:
-1. name
-2. label (implied by name)
-3. value
-
-Android name = iOS name & label
-Android text = iOS value
-=end
-
-def first_ele_js predicate
-  # returnElems requires a wrapped $(element).
-  # set to empty array when length is zero to prevent hang.
-  #
-  # UIAElementNil when not matched
-  #
-  # 1. secureTextFields
-  # 2. textFields
-  # 3. buttons
-  # 4. elements
-  %Q(
-    function isNil( a ) {
-      return a.type() === 'UIAElementNil';
-    }
-
-    var w = au.mainWindow;
-    var search = "#{predicate}";
-    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);
-        }
-      }
-    }
-
-    if ( a.length === 0 ) {
-      a = [];
-    }
-
-    au._returnElems($(a));
-  )
-end
-
-def all_ele_js predicate
-  %Q(
-    var w = au.mainWindow;
-    var search = "#{predicate}";
-    var a = w.elements().withPredicate(search).toArray();
-
-    if ( a.length === 0 ) {
-      a = [];
-    }
-
-    au._returnElems($(a));
-  )
-end
-
-# Return the first element matching text.
-# @param text [String] the text to search for
-# @return [Element] the first matching element
-def find text
-  js = first_ele_js "name contains[c] '#{text}' || label contains[c] '#{text}' || value contains[c] '#{text}'"
-
-  execute_script(js).first
-end
-
-# Return all elements matching text.
-# @param text [String] the text to search for
-# @return [Array<Element>] all matching elements
-def finds text
-  # returnElems requires a wrapped $(element).
-  # must call toArray when using withPredicate instead of firstWithPredicate.
-  js = all_ele_js "name contains[c] '#{text}' || label contains[c] '#{text}' || value contains[c] '#{text}'"
-
-  execute_script js
-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
-  js = first_ele_js "value contains[c] '#{text}'"
-
-  execute_script(js).first
-end
-
-# Return all elements matching text.
-# @param text [String] the text to search for
-# @return [Array<Element>] all matching elements
-def texts text
-  # XPath //* is not implemented on iOS
-  # https://github.com/appium/appium/issues/430
-    js = all_ele_js "value contains[c] '#{text}'"
-
-  execute_script js
-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 text
-  js = first_ele_js "name contains[c] '#{text}' || label contains[c] '#{text}'"
-
-  execute_script(js).first
-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 text
-  # find_elements :name is not the same as on Android.
-  # it's case sensitive and exact on iOS and not on Android.
-  # https://github.com/appium/appium/issues/379
-  js = all_ele_js "name contains[c] '#{text}' || label contains[c] '#{text}''"
-
-  execute_script js
-end
-
-end # if ios

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

@@ -1,93 +0,0 @@
-# encoding: utf-8
-if $os == :ios
-# UIATextField & UIASecureTextField methods
-#
-# Find textfield and then secure elements in one server call
-# to match Android.
-
-# Get an array of textfield texts.
-# @return [Array<String>]
-def textfields
-  find_2_eles_attr :textfield, :secure, :text
-end
-
-# Get an array of textfield elements.
-# @return [Array<Textfield>]
-def e_textfields
-  execute_script textfield_js
-end
-
-# Get the first textfield element.
-# @return [Textfield]
-def first_textfield
-  js = textfield_js 'r = r.length > 0 ? $(r[0]) : r;'
-  execute_script(js).first
-end
-
-# Get the last textfield element.
-# @return [Textfield]
-def last_textfield
-  js = textfield_js 'r = r.length > 0 ? $(r[r.length - 1]) : r;'
-  execute_script(js).first
-end
-
-# Get the first textfield that matches text.
-# @param text [String, Integer] the text to match exactly. If int then the textfield at that index is returned.
-# @return [Textfield]
-def textfield text
-  # Don't use ele_index because that only works on one element type.
-  # iOS needs to combine textfield and secure to match Android.
-  if text.is_a? Numeric
-    js = textfield_js 'r = r.length > 0 ? $(r[#{text}]) : r;'
-    return execute_script(js).first
-  end
-
-  textfield_include text
-end
-
-# Get the first textfield that includes text.
-# @param text [String] the text the textfield must include
-# @return [Textfield]
-def textfield_include text
-  js = %Q(
-    var t = au.getElementsByXpath('textfield[contains(@text, "#{text}")]').value;
-    var s = au.getElementsByXpath('secure[contains(@text, "#{text}")]').value;
-    t.concat(s)[0];
-  )
-
-  puts js if defined?(Pry)
-
-  execute_script js
-end
-
-# Get the first textfield that exactly matches text.
-# @param text [String] the text the textfield must exactly match
-# @return [Textfield]
-def textfield_exact text
-  # find_ele_by_text :textfield, text
-  js = %Q(
-    var t = au.getElementsByXpath('textfield[@text="#{text}"]').value;
-    var s = au.getElementsByXpath('secure[@text="#{text}"]').value;
-    t.concat(s)[0];
-  )
-
-  puts js if defined?(Pry)
-
-  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=''
-%Q(
-  var t = au.lookup('textfield');
-  var s = au.lookup('secure');
-  var r = $(t.concat(s));
-  #{filter}
-  au._returnElems(r);
-)
-end
-
-end # if $os

data/lib/appium_lib/element/text.rb

@@ -1,43 +0,0 @@
-# encoding: utf-8
-# UIAStaticText methods
-
-# s_ prefix for static_text to avoid conflict with generic text methods.
-
-# Get an array of text texts.
-# @return [Array<String>]
-def s_texts
-  find_eles_attr :text, :text
-end
-
-# Get an array of text elements.
-# @return [Array<Text>]
-def s_e_texts
-  find_eles :text
-end
-
-# Get the first text element.
-# @return [Text]
-def s_first_text
-  first_ele :text
-end
-
-# Get the last text element
-# @return [Text]
-def s_last_text
-  last_ele :text
-end
-
-# Get the first element that includes text.
-# @param text [String, Integer] the text to find. If int then the text at that index is returned.
-# @return [Text]
-def s_text text
-  return ele_index :text, text if text.is_a? Numeric
-  find_ele_by_text_include :text, text
-end
-
-# Get the first textfield that matches text.
-# @param text [String] the text that the tag must match
-# @return [Text]
-def s_text_exact text
-  find_ele_by_text :text, text
-end