appium_lib 0.24.1 → 1.0.0

data/ios_tests/lib/ios/specs/common/patch.rb

@@ -0,0 +1,50 @@
+=begin
+  Skip:
+    status # status patches are already tested in driver.rb
+    raw_execute # debug output for Pry
+=end
+# rake ios[common/patch]
+describe 'common/patch.rb' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+# Attributes are busted in Android.
+# Blocked on https://github.com/appium/appium/issues/628
+  describe 'Selenium::WebDriver::Element methods' do
+    # todo: t 'value' do; end
+
+    t 'name' do
+      first_s_text.name.must_equal 'UICatalog'
+    end
+
+    # t 'tag_name' do; end # Doesn't work on Android
+
+    t 'location_rel' do
+      loc = first_s_text.location_rel
+      loc.x.class.must_equal String
+      loc.y.class.must_equal String
+    end
+  end
+
+  describe 'common patch' do
+    # By default, the webdriver gem will return message instead of origValue
+    # {"message":"An unknown server-side error occurred while processing the command.","origValue":"Strategy id is not valid."}
+    t 'error_message' do
+      value = ''
+      begin
+        set_wait 0
+        find_element(:css, 'ok')
+      rescue Exception => e;
+        value = e.message
+      ensure
+        set_wait
+      end
+      value.must_equal "Invalid locator strategy: css selector"
+    end
+  end
+end

data/ios_tests/lib/ios/specs/common/version.rb

@@ -0,0 +1,17 @@
+describe 'version.rb' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  t '::Appium::VERSION' do
+    ::Appium::VERSION.must_match /(\d+)\.(\d+).(\d+)/
+  end
+
+  t '::Appium::DATE' do
+    ::Appium::DATE.must_match /(\d+)\-(\d+)\-(\d+)/
+  end
+end

data/ios_tests/lib/ios/specs/device/device.rb

@@ -0,0 +1,82 @@
+describe 'device/device' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  t 'lock' do
+    lock 5
+    tag('UIAButton').name.must_equal 'SlideToUnlock'
+
+    # It appears that lockForDuration doesn't.
+    close_app
+    launch
+  end
+
+  t 'background_app' do
+    background_app 5
+    screen.must_equal catalog
+  end
+
+  t 'is_installed' do
+    installed = is_installed? "Derrp"
+    installed.must_equal false
+  end
+
+  t 'shake' do
+    shake
+  end
+
+  t 'close and launch' do
+    close_app
+    launch
+    tag('UIANavigationBar').name.must_equal 'UICatalog'
+  end
+
+  t 'reset' do
+    reset
+  end
+
+  t 'available_contexts' do
+    available_contexts.must_equal ["NATIVE_APP"]
+  end
+
+  t 'current_context' do
+    current_context.must_equal nil
+  end
+
+  t 'switch_to_default_context' do
+    switch_to_default_context
+    current_context.must_equal nil
+  end
+
+  t 'app_strings' do
+    app_strings.must_include "SearchBarExplain"
+  end
+
+  t 'action_chain' do
+    ac = Appium::TouchAction.new
+    e  = find_element(:name, 'Buttons, Various uses of UIButton')
+    ac.press element: e, x: 10, y: 10
+    ac.perform
+    back
+  end
+
+  t 'swipe' do
+    swipe start_x: 75, start_y: 500, end_x: 75, end_y: 0, duration: 0.8
+  end
+
+  t 'pinch & zoom' do
+    s_text('Images, Use of UIImageView').click
+    zoom 200
+    pinch 75
+  end
+
+  t 'file movement' do
+    read_file = pull_file 'Library/AddressBook/AddressBook.sqlitedb'
+    read_file.start_with?('SQLite format').must_equal true
+  end
+end

data/ios_tests/lib/ios/specs/device/multi_touch.rb

@@ -0,0 +1,12 @@
+describe 'device/multi_touch' do
+  t { } # place holder test
+end
+
+# todo: write tests
+=begin
+pinch
+zoom
+initialize
+add
+perform
+=end

data/ios_tests/lib/ios/specs/device/touch_actions.rb

@@ -0,0 +1,15 @@
+describe 'device/touch_actions' do
+  t { } # place holder test
+end
+# todo: write tests
+=begin
+move_to
+press_for_duration
+press
+release
+tap
+wait
+swipe
+perform
+cancel
+=end

data/ios_tests/lib/ios/specs/driver.rb

@@ -0,0 +1,203 @@
+# rake ios[driver]
+describe 'driver' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  def is_sauce
+    ENV['UPLOAD_FILE'] && ENV['SAUCE_USERNAME']
+  end
+
+  t 'load_appium_txt' do
+    # skip this test if we're using Sauce
+    # the storage API doesn't have an on disk file
+    skip if is_sauce
+    # __FILE__ is '(eval)' so use env var set by the Rakefile
+    path = ENV['APPIUM_TXT']
+    opts = Appium.load_appium_txt file: path, verbose: true
+
+    actual   = ''
+    actual   = File.basename opts[:caps][:app] if opts && opts[:caps]
+    expected = 'UICatalog.app'
+    assert_equal expected, actual
+  end
+
+  describe 'Appium::Driver attributes' do
+    t 'verify all attributes' do
+      2.times { set_wait 30 } # must set twice to validate last_waits
+      actual              = driver_attributes
+      actual[:caps][:app] = File.basename actual[:caps][:app]
+      expected            = { caps:             { platformName: 'ios',
+                                                  app:          'UICatalog.app' },
+                              custom_url:       false,
+                              export_session:   false,
+                              default_wait:     30,
+                              last_waits:       [30, 30],
+                              sauce_username:   nil,
+                              sauce_access_key: nil,
+                              port:             4723,
+                              device:           :ios,
+                              debug:            true }
+
+      if actual != expected
+        diff = HashDiff.diff expected, actual
+        diff = "diff (expected, actual):\n#{diff}"
+        # example:
+        # change :ios in expected to match 'ios' in actual
+        # [["~", "caps.platformName", :ios, "ios"]]
+        message = "\n\nactual:\n\n: #{actual.ai}expected:\n\n#{expected.ai}\n\n#{diff}"
+        fail message
+      end
+    end
+
+    t 'verify attributes are immutable' do
+      driver_attributes[:caps][:app] = 'fake'
+      actual = File.basename driver_attributes[:caps][:app]
+      expected = 'UICatalog.app'
+      actual.must_equal expected
+    end
+
+    t 'no_wait' do
+      no_wait
+      default_wait.must_equal 0
+      set_wait 30
+    end
+
+    t 'default_wait attr' do
+      set_wait 31 # set wait and no_wait update default_wait
+      default_wait.must_equal 31
+      set_wait 30
+    end
+
+    t 'app_path attr' do
+      apk_name = File.basename driver_attributes[:caps][:app]
+
+      if is_sauce
+        apk_name.must_equal 'sauce-storage:UICatalog6.1.app.zip'
+      else
+        apk_name.must_equal 'UICatalog.app'
+      end
+    end
+
+    # Only used for Sauce Labs
+    t 'app_name attr' do
+      name_attr = driver_attributes[:caps][:name]
+      if is_sauce
+        name_attr.must_equal 'appium_lib_ios'
+      else
+        name_attr.must_be_nil
+      end
+    end
+
+    t 'sauce_username attr' do
+      sauce_username = driver_attributes[:sauce_username]
+      if is_sauce
+        sauce_username.must_equal 'appiumci'
+      else
+        sauce_username.must_be_nil
+      end
+    end
+
+    t 'sauce_access_key attr' do
+      sauce_access_key = driver_attributes[:sauce_access_key]
+      if is_sauce
+        sauce_access_key.must_match /\h{8}-\h{4}-\h{4}-\h{4}-\h{12}/
+      else
+        sauce_access_key.must_be_nil
+      end
+    end
+  end
+
+  describe 'Appium::Driver' do
+    t '@@loaded' do
+      loaded = $driver.class.class_variable_get :@@loaded
+      loaded.must_equal true
+    end
+
+    t '$driver.class' do
+      $driver.class.must_equal Appium::Driver
+    end
+  end
+
+  describe 'methods' do
+    t 'status' do
+      appium_server_version['build'].keys.sort.must_equal %w(revision version)
+    end
+
+    t 'server_version' do
+      server_version = appium_server_version['build']['version']
+      if is_sauce
+        server_version.must_match 'Sauce OnDemand'
+      else
+        server_version.must_match /(\d+)\.(\d+).(\d+)/
+      end
+    end
+
+    t 'restart' do
+      restart
+      s_text 'buttons'
+    end
+
+    t 'driver' do
+      driver.browser.must_equal :iOS
+    end
+
+=begin
+  Skip:
+    screenshot   # this is slow and already tested by Appium
+    driver_quit  # tested by restart
+    start_driver # tested by restart
+=end
+    t 'set_wait' do
+      # fill the @last_waits array with: [30, 30]
+      set_wait(30).must_equal(30)
+      set_wait(30).must_equal(30)
+
+      # verify set_wait with no args works correctly
+      set_wait.must_equal(30)
+      set_wait(30).must_equal(30)
+      set_wait.must_equal(30)
+
+      set_wait(2).must_equal(2)
+      set_wait.must_equal(30)
+      set_wait(3).must_equal(3)
+      set_wait.must_equal(2)
+
+      set_wait(2).must_equal(2)
+      set_wait(3).must_equal(3)
+      set_wait.must_equal(2)
+    end
+
+    t 'default_wait' do
+      set_wait 30
+      default_wait.must_equal 30 # set in run.rb
+    end
+
+    # returns true unless an error is raised
+    t 'exists' do
+      exists(0, 0) { true }.must_equal true
+      exists(0, 0) { raise 'error' }.must_equal false
+    end
+
+    # any script
+    t 'execute_script' do
+      execute_script %q(au.mainApp().getFirstWithPredicate("name contains[c] 'button'");)
+    end
+
+    # any elements
+    t 'find_elements' do
+      find_elements(:class, 'UIAStaticText').length.must_equal 13
+    end
+
+    # any element
+    t 'find_element' do
+      find_element(:class, 'UIAStaticText').class.must_equal Selenium::WebDriver::Element
+    end
+
+    # Skip: x # x is only used in Pry
+  end
+end

data/ios_tests/lib/ios/specs/ios/element/alert.rb

@@ -0,0 +1,48 @@
+# rake ios[ios/element/alert]
+describe 'ios/element/alert' do
+  def nav_once
+    screen.must_equal catalog
+    wait_true { s_text('alerts').click; tag('UIANavigationBar').name == 'Alerts' } # wait for true
+    tag('UIANavigationBar').name.must_equal 'Alerts'
+
+    # redefine method as no-op after it's invoked once
+    self.class.send :define_method, :nav_once, proc {}
+  end
+
+  def after_last
+    alert_accept if exists { s_text('UIActionSheet <title>') }
+    back_click
+    screen.must_equal catalog
+    sleep 1
+  end
+
+  before do
+    nav_once
+    open_alert
+  end
+
+  def open_alert
+    wait_true do
+      return true if exists { s_text('UIActionSheet <title>') }
+      s_text('Show OK-Cancel').click
+      s_text('UIActionSheet <title>').displayed?
+    end
+  end
+
+  # iOS 7 is not using the alert methods. alert is nil.
+  def ios7_alert_detected
+    execute_script 'UIATarget.localTarget().frontMostApp().alert().isNil()'
+  end
+
+  t 'alert_accept' do
+    alert_accept
+  end
+
+  t 'alert_dismiss' do
+    alert_dismiss
+  end
+
+  t 'after_last' do
+    after_last
+  end
+end

data/ios_tests/lib/ios/specs/ios/element/button.rb

@@ -0,0 +1,58 @@
+# rake ios['ios/element/button']
+describe 'ios/element/button' do
+  def before_first
+    screen.must_equal catalog
+    # nav to buttons activity
+    wait { s_text('buttons').click }
+  end
+
+  def after_last
+    # nav back to start
+    back_click
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  def gray
+    'Gray'
+  end
+
+  t 'button' do
+    # by index
+    button(2).name.must_equal gray
+
+    # by name contains
+    button('ray').name.must_equal gray
+  end
+
+  t 'buttons' do
+    exp = ['Back', 'Gray', 'Right pointing arrow']
+    buttons('a').map { |e| e.name }.must_equal exp
+  end
+
+  t 'first_button' do
+    first_button.name.must_equal 'Back'
+  end
+
+  t 'last_button' do
+    last_button.name.must_equal 'Rounded'
+  end
+
+  t 'button_exact' do
+    button_exact(gray).name.must_equal gray
+  end
+
+  t 'buttons_exact' do
+    buttons_exact(gray).first.name.must_equal gray
+  end
+
+  t 'e_buttons' do
+    e_buttons.length.must_equal 4
+  end
+
+  t 'after_last' do
+    after_last
+  end
+end