appium_lib 0.24.1 → 1.0.0

data/android_tests/lib/android/specs/android/element/generic.rb

@@ -0,0 +1,48 @@
+# rake android['android/element/generic']
+describe 'android/element/generic' do
+
+  def content
+    'Content'
+  end
+
+  def partial
+    'tent'
+  end
+
+  t 'find works before and after get_source' do
+    wait { find(partial).text.must_equal content }
+    wait { get_source.class.must_equal String }
+    wait { find(partial).text.must_equal content }
+  end
+
+  t 'find' do
+    wait { find(partial).text.must_equal content }
+  end
+
+  t 'finds' do
+    wait { finds(partial).first.text.must_equal content }
+  end
+
+  t 'find_exact' do
+    wait { find_exact(content).text.must_equal content }
+  end
+
+  t 'finds_exact' do
+    wait { finds_exact(content).first.text.must_equal content }
+  end
+
+  # scroll_to is broken
+  t 'scroll_to' do
+    wait { find('Views').click }
+    wait { scroll_to('rotating button').text.must_equal 'Rotating Button' }
+    # back to start activity
+    back
+  end
+
+  t 'scroll_to_exact' do
+    wait { find('Views').click }
+    wait { scroll_to_exact('Rotating Button').text.must_equal 'Rotating Button' }
+    # back to start activity
+    back
+  end
+end

data/android_tests/lib/android/specs/android/element/text.rb

@@ -0,0 +1,39 @@
+# rake android['android/element/text']
+describe 'android/element/text' do
+
+  def must_raise_no_element &block
+    proc { block.call }.must_raise Selenium::WebDriver::Error::NoSuchElementError
+  end
+
+  t 's_text' do
+    wait { s_text(1).text.must_equal 'API Demos' }
+    wait { s_text('mos').text.must_equal 'API Demos' }
+  end
+
+  t 's_texts' do
+    wait { s_texts('i').length.must_equal 7 }
+  end
+
+  t 'first_s_text' do
+    wait { first_s_text.text.must_equal 'API Demos' }
+  end
+
+  t 'last_s_text' do
+    wait { last_s_text.text.must_equal 'Views' }
+  end
+
+  t 's_text_exact' do
+    must_raise_no_element { s_text_exact 'mos' }
+
+    # should pass
+    wait { s_text_exact('API Demos').text.must_equal 'API Demos' }
+  end
+
+  t 's_texts_exact' do
+    wait { s_texts_exact('API Demos').length.must_equal 1 }
+  end
+
+  t 'e_s_texts' do
+    wait { e_s_texts.length.must_equal 14 }
+  end
+end

data/android_tests/lib/android/specs/android/element/textfield.rb

@@ -0,0 +1,60 @@
+describe 'android/element/textfield' do
+  def must_raise_no_element &block
+    proc { block.call }.must_raise Selenium::WebDriver::Error::NoSuchElementError
+  end
+
+  def left
+    'Left is best'
+  end
+
+  def right
+    'Right is always right'
+  end
+
+  def before_first
+    # nav to activity
+    wait { find('app').click }
+    wait { find('activity').click }
+    wait { find('custom title').click }
+  end
+
+  def after_last
+    # back to start
+    3.times { back }
+  end
+
+  t { before_first }
+
+  t 'textfield' do
+    wait { textfield(1).text.must_equal left }
+    wait { textfield('right').text.must_equal right }
+  end
+
+  t 'textfields' do
+    wait { textfields('right').first.text.must_equal right }
+  end
+
+  t 'first_textfield' do
+    wait { first_textfield.text.must_equal left }
+  end
+
+  t 'last_textfield' do
+    wait { last_textfield.text.must_equal right }
+  end
+
+  t 'textfield_exact' do
+    must_raise_no_element { textfield_exact 'zz' }
+    wait { textfield_exact(left).text.must_equal left }
+  end
+
+  t 'textfields_exact' do
+    wait { textfields_exact('zz').must_equal [] }
+    wait { textfields_exact(left).first.text.must_equal left }
+  end
+
+  t 'e_textfields' do
+    wait { e_textfields.length.must_equal 2 }
+  end
+
+  t { after_last }
+end

data/android_tests/lib/android/specs/android/helper.rb

@@ -0,0 +1,80 @@
+# rake android[android/helper]
+describe 'android/helper' do
+  t 'tags' do
+    wait { tags('android.widget.TextView').length.must_equal 14 }
+  end
+
+  def page_class_data
+    (<<-TXT).strip
+12x android.widget.TextView
+4x android.widget.FrameLayout
+2x android.widget.LinearLayout
+2x android.view.View
+1x android.widget.ListView
+1x android.widget.ImageView
+1x hierarchy
+    TXT
+  end
+
+  # t 'get_selendroid_inspect' # only works on selendroid
+  t 'get_page_class' do
+    # digit values change based on screen size
+    # larger screens have more elements
+    wait do
+      exp = page_class_data.gsub(/\d+/, '')
+      act = get_page_class.gsub(/\d+/, '')
+      act.must_equal exp
+    end
+  end
+
+  # t 'page_class' do # tested by get_page_class
+
+  t 'get_android_inspect' do
+    # line count changes based on screen size
+    wait { get_android_inspect.split("\n").length.must_be :>=, 40 }
+  end
+
+  # t 'get_inspect' do # tested by get_android_inspect
+  # t 'page' do # tested by get_android_inspect
+
+  def id_key
+    'animation_2_instructions'
+  end
+
+  def id_value
+    'Select an animation:'
+  end
+
+  t 'xml_keys' do
+    wait do
+      id_pair = xml_keys id_key
+      id_pair = id_pair.to_a[0]
+      id_pair.length.must_equal 2
+      id_pair.first.must_equal id_key
+      id_pair.last.must_equal id_value
+    end
+  end
+
+  t 'resolve_id' do
+    wait do
+      str = resolve_id id_key
+      str.must_equal id_value
+    end
+  end
+
+  t 'xml_values' do
+    wait do
+      value = xml_values(id_value).first.last
+      value.must_equal id_value
+    end
+  end
+
+  t 'find by id' do
+    wait do
+      find('accessibility').click
+      find('accessibility node provider').click
+      id 'accessibility_node_provider' # Accessibility/Accessibility Node Provider
+      2.times { back }
+    end
+  end
+end

data/android_tests/lib/android/specs/android/patch.rb

@@ -0,0 +1,14 @@
+describe 'android/patch.rb' do
+  t 'type' do
+    # nav to textfield
+    wait { find('app').click }
+    wait { find('search').click }
+    wait { find('invoke').click }
+
+    wait { first_textfield.type 'ok' }
+    wait { first_textfield.text.must_equal 'ok' }
+
+    # nav to start activity
+    3.times { back }
+  end
+end

data/android_tests/lib/android/specs/common/device.rb

@@ -0,0 +1,117 @@
+describe 'common/device' do
+  # Not yet implemented
+  t 'shake' do
+    # todo: write test
+  end
+
+  t 'remove & install' do
+    # todo: write test
+    #remove 'com.example.android.apis'
+    #install ENV['APP_PATH']
+  end
+
+  t 'background_app' do
+    wait { background_app 5 }
+  end
+
+  t 'is_installed' do
+    wait { is_installed?('fake_app').must_equal false }
+  end
+
+  t 'reset' do
+    reset
+    wait { s_text(1).text.must_equal 'API Demos' }
+  end
+
+  t 'close & launch' do
+    close_app
+    launch
+  end
+
+  t 'current_activity' do
+    wait { current_activity.must_equal '.ApiDemos' }
+  end
+
+  t 'available_contexts' do
+    wait { available_contexts.must_equal ['NATIVE_APP'] }
+  end
+
+  t 'current_context' do
+    wait { current_context.must_equal 'NATIVE_APP' }
+  end
+
+  t 'current_context=' do
+    wait do
+      current_context= 'WEBVIEW'
+      current_context.must_equal 'WEBVIEW'
+    end
+  end
+
+  t 'within_context' do
+    $driver.within_context 'NATIVE_APP' do
+      wait { current_context.must_equal 'NATIVE_APP' }
+    end
+  end
+
+  t 'switch_to_default_context' do
+    wait do
+      switch_to_default_context
+      current_context.must_equal 'NATIVE_APP'
+    end
+  end
+
+  t 'app_strings' do
+    wait do
+      strs = app_strings
+      strs.has_key?('activity_save_restore').must_equal true
+    end
+  end
+
+  def must_return_element element
+    element.class.must_equal Selenium::WebDriver::Element
+  end
+
+  t 'complex_find' do
+    wait { find('Views').click }
+    wait { must_return_element complex_find(mode: 'scroll', selectors: [[[3, 'tabs']]]) }
+    wait { must_return_element complex_find(mode: 'all', selectors: [[[3, 'i']]]).first }
+    wait { must_return_element complex_find(selectors: [[[3, 'tabs']]]) }
+    back
+  end
+
+  t 'key_event' do
+    key_event 176
+  end
+
+  t 'action_chain' do
+    wait do
+      e = find_element(:name, 'Accessibility')
+      Appium::TouchAction.new.press(:element => e, x: 0.5, y: 0.5).release(:element => e).perform
+    end
+    wait { find_element(:name, 'Custom View') }
+    back
+  end
+
+  t 'swipe' do
+    wait { Appium::TouchAction.new.swipe(start_x: 0.75, start_y: 0.25, end_x: 0.75, end_y: 0.5, duration: 1.5).perform }
+  end
+
+  t 'pinch & zoom' do
+    wait do
+      s_text('Graphics').click
+      s_text('BitmapMesh').click
+      zoom 200
+      pinch 75
+    end
+  end
+
+  t 'push and pull file' do
+    wait do
+      file = "A Fine Day"
+      path = "/data/local/tmp/remote.txt"
+      push_file path, file
+      read_file = pull_file path
+      read_file.must_equal file
+    end
+  end
+end

data/android_tests/lib/android/specs/common/element/window.rb

@@ -0,0 +1,9 @@
+describe 'common/element/window' do
+  t 'window_size' do
+    wait do
+      size = window_size
+      size.width.class.must_equal Fixnum
+      size.height.class.must_equal Fixnum
+    end
+  end
+end

data/android_tests/lib/android/specs/common/helper.rb

@@ -0,0 +1,112 @@
+describe 'common/helper' do
+  wait_time = [0.2, 0.2] # max_wait, interval
+
+  # wait is a success unless an error is raised
+  # max_wait=0 is infinity to use 0.1
+  t 'wait' do
+    # successful wait should not raise error
+    wait(*wait_time) { true }
+    wait(*wait_time) { false }
+    wait(*wait_time) { nil }
+
+    # failed wait should error
+    proc { wait(*wait_time) { raise } }.must_raise Timeout::Error
+
+    # regular rescue will not handle exceptions outside of StandardError hierarchy
+    # must rescue Exception explicitly to rescue everything
+    proc { wait(*wait_time) { raise NoMemoryError } }.must_raise Timeout::Error
+  end
+
+  t 'ignore' do
+    # ignore should rescue all exceptions
+    ignore { true }
+    ignore { false }
+    ignore { nil }
+    ignore { raise }
+    ignore { raise NoMemoryError }
+  end
+
+  # wait_true is a success unless the value is not true
+  t 'wait_true' do
+    # successful wait should not error
+    wait_true(*wait_time) { true }
+
+    # failed wait should error
+    proc { wait_true(*wait_time) { false } }.must_raise Timeout::Error
+    proc { wait_true(*wait_time) { nil } }.must_raise Timeout::Error
+
+    # raise should error
+    proc { wait_true(*wait_time) { raise } }.must_raise Timeout::Error
+
+    # regular rescue will not handle exceptions outside of StandardError hierarchy
+    # must rescue Exception explicitly to rescue everything
+    proc { wait(*wait_time) { raise NoMemoryError } }.must_raise Timeout::Error
+  end
+
+  t 'back' do
+    # start page
+    wait { e_s_texts.length.must_equal 14 }
+    # nav to new page.
+    # ele 0 is the title and can't be clicked.
+    wait { s_text(2).click }
+    wait { e_s_texts.length.must_equal 8 }
+    # go back
+    back
+    # start page
+    wait { find 'NFC' }
+  end
+
+  t 'session_id' do
+    wait { session_id.must_match /\h{8}-\h{4}-\h{4}-\h{4}-\h{12}/ }
+  end
+
+  t 'xpath' do
+    wait { xpath('//android.widget.TextView').name.must_equal 'API Demos' }
+  end
+
+  t 'xpaths' do
+    wait { xpaths('//android.widget.TextView').length.must_equal 14 }
+  end
+
+  t 'ele_index' do
+    wait { ele_index('android.widget.TextView', 2).name.must_equal 'Accessibility' }
+  end
+
+  t 'tags' do
+    wait { tags('android.widget.TextView').length.must_equal 14 }
+  end
+
+  t 'find_ele_by_attr_include' do
+    wait do
+      el_text = find_ele_by_attr_include('android.widget.TextView', :text, 'acc').text
+      el_text.must_equal 'Accessibility'
+    end
+  end
+
+  t 'find_eles_by_attr_include' do
+    wait do
+      ele_count = find_eles_by_attr_include('android.widget.TextView', :text, 'e').length
+      ele_count.must_equal 9
+    end
+  end
+
+  t 'first_ele' do
+    wait do
+      first_ele('android.widget.TextView').text.must_equal 'API Demos'
+    end
+  end
+
+  t 'last_ele' do
+    wait do
+      last_ele('android.widget.TextView').text.must_equal 'Views'
+    end
+  end
+
+  # t 'source' do # tested by get_source
+
+  t 'get_source' do
+    wait do
+      get_source.class.must_equal String
+    end
+  end
+end