appium_lib 9.4.5 → 9.4.6

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

@@ -1,34 +0,0 @@
-# rake android[common/device_touchaction]
-describe 'common/device_touchaction' do
-  t 'action_chain' do
-    wait do
-      e = text('Accessibility')
-      touch_action = Appium::TouchAction.new.press(element: e, x: 0.5, y: 0.5).release(element: e)
-      touch_action.perform
-      touch_action.actions.must_equal []
-    end
-    wait { text('Custom View') }
-    back
-    wait { text_exact 'NFC' }
-  end
-
-  t 'swipe' do
-    wait { Appium::TouchAction.new.swipe(start_x: 0.75, start_y: 0.25, end_x: 0.75, end_y: 50).perform }
-    wait { !exists { text_exact 'NFC' } }
-    wait { text_exact 'Bouncing Balls' }
-    back
-    wait { text_exact 'NFC' }
-  end
-
-  t 'pinch & zoom' do
-    wait { text_exact 'NFC' }
-    wait { text_exact('Graphics').click }
-    wait { text('BitmapMesh').click }
-    wait do
-      zoom 200
-      pinch 75
-    end
-    2.times { back }
-    wait { text_exact 'NFC' }
-  end
-end

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

@@ -1,11 +0,0 @@
-# rake android[common/element/window]
-describe 'common/element/window' do
-  # rubocop:disable Lint/UnifiedInteger
-  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

@@ -1,112 +0,0 @@
-describe 'common/helper' do
-  wait_opts = { timeout: 0.2, interval: 0.2 } # max_wait, interval
-
-  # There's no `must_not_raise` as the opposite of must_raise
-
-  # By default code is expected to not raise exceptions.
-  # must_not_raise is a no-op.
-
-  # 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_opts) { true }
-    wait(wait_opts) { false }
-    wait(wait_opts) { nil }
-
-    # failed wait should error
-    proc { wait(wait_opts) { raise } }.must_raise Selenium::WebDriver::Error::TimeOutError
-
-    # regular rescue will not handle exceptions outside of StandardError hierarchy
-    # must rescue Exception explicitly to rescue everything
-    proc { wait(wait_opts) { raise NoMemoryError } }.must_raise Selenium::WebDriver::Error::TimeOutError
-    proc { wait(timeout: 0.2, interval: 0.0) { raise NoMemoryError } }.must_raise Selenium::WebDriver::Error::TimeOutError
-
-    # invalid keys are rejected
-    proc { wait(invalidkey: 2) { true } }.must_raise RuntimeError
-  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_opts) { true }
-
-    # failed wait should error
-    proc { wait_true(wait_opts) { false } }.must_raise Selenium::WebDriver::Error::TimeOutError
-    proc { wait_true(wait_opts) { nil } }.must_raise Selenium::WebDriver::Error::TimeOutError
-
-    # raise should error
-    proc { wait_true(wait_opts) { raise } }.must_raise Selenium::WebDriver::Error::TimeOutError
-
-    # regular rescue will not handle exceptions outside of StandardError hierarchy
-    # must rescue Exception explicitly to rescue everything
-    proc { wait_true(wait_opts) { raise NoMemoryError } }.must_raise Selenium::WebDriver::Error::TimeOutError
-    proc { wait_true(timeout: 0.2, interval: 0.0) { raise NoMemoryError } }
-      .must_raise Selenium::WebDriver::Error::TimeOutError
-
-    # invalid keys are rejected
-    proc { wait_true(invalidkey: 2) { true } }.must_raise RuntimeError
-  end
-
-  t 'back' do
-    # start page
-    wait { texts.length.must_equal 13 }
-    # nav to new page.
-    # ele 0 is the title and can't be clicked.
-    wait { text(2).click }
-    wait { texts.length.must_equal 5 }
-    # 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 13 }
-  end
-
-  t 'ele_index' do
-    wait { ele_index('android.widget.TextView', 3).name.must_equal 'Accessibility' }
-  end
-
-  t 'tags' do
-    wait { tags('android.widget.TextView').length.must_equal 13 }
-  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

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

@@ -1,78 +0,0 @@
-# rubocop:disable Lint/RescueException
-# rubocop:disable Metrics/LineLength
-
-# Skip:
-#   status # status patches are already tested in driver.rb
-#   raw_execute # debug output for Pry
-
-describe 'common/patch' do
-  # Attributes are busted in Android.
-  # Blocked on https://github.com/appium/appium/issues/628
-  describe 'Selenium::WebDriver::Element methods' do
-    # Android supports exactly two string Attributes
-    # .name and .text
-    # https://github.com/appium/appium/blob/ea3450e7f78d1794bab42fa396a387e7b86fd3b3/android/bootstrap/src/io/appium/android/bootstrap/handler/GetAttribute.java#L43
-    # t 'value' do; end # Doesn't work on Android
-
-    t 'name' do
-      wait { first_text.name.must_equal 'API Demos' }
-    end
-
-    # t 'tag_name' do; end # Doesn't work on Android
-
-    t 'location_rel' do
-      wait do
-        loc = first_text.location_rel
-        loc.x.class.must_equal String
-        loc.y.class.must_equal String
-      end
-    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 'id error_message' do
-      value = ''
-      begin
-        set_wait 0
-        find_element(:id, 'ok')
-      rescue Exception => e
-        value = e.message
-      ensure
-        set_wait 30
-      end
-      value = value.split("\n").first.strip
-      exp   = 'An element could not be located on the page using the given search parameters.'
-      value.must_equal exp
-    end
-
-    t 'id success' do
-      if !automation_name_is_uiautomator2?
-        wait do
-          el = id 'autocomplete_3_button_7' # <string name="autocomplete_3_button_7">Text</string>
-          el.name.must_equal 'Text'
-        end
-      else
-        wait do
-          el = text 'text' # <string name="autocomplete_3_button_7">Text</string>
-          el.name.must_equal 'Text'
-        end
-      end
-    end
-
-    t 'find many elements by resource id' do
-      wait do
-        value = find_elements(:id, 'android:id/text1').length
-        value.must_equal 12
-      end
-    end
-
-    t 'find single element by resource id' do
-      wait do
-        value = id('android:id/text1').text
-        value.must_equal "Access'ibility"
-      end
-    end
-  end
-end

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

@@ -1,9 +0,0 @@
-describe 'version.rb' do
-  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/android_tests/lib/android/specs/common/web_context.rb

@@ -1,60 +0,0 @@
-# Tests specifically for areas where the web_context differs in behaviour
-# rake android[common/web_context]
-describe 'the web context' do
-  # appium's context support is broken on android
-
-  t 'available_contexts' do
-    wait_true { available_contexts.include? 'NATIVE_APP' }
-  end
-
-  t 'current_context' do
-    wait { current_context.must_equal 'NATIVE_APP' }
-  end
-
-  t 'set_context' do
-    wait { scroll_to('Views').click }
-    wait { scroll_to('WebView').click }
-
-    def undo_setcontext_nav
-      back
-      wait { find('WebView') }
-      back
-      wait { find 'Views' }
-    end
-
-    contexts        = available_contexts
-    webview_context = contexts.detect { |e| e.start_with?('WEBVIEW') }
-
-    if webview_context.nil?
-      undo_setcontext_nav
-      raise "No webview context found. contexts are: #{contexts}"
-    end
-
-    wait { set_context webview_context }
-    wait { current_context.must_equal webview_context }
-
-    # verify inspect within webview works
-    get_android_inspect.split("\n").length.must_be :>=, 3
-
-    wait { set_context 'NATIVE_APP' }
-    wait { current_context.must_equal 'NATIVE_APP' }
-
-    undo_setcontext_nav
-  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
-
-    wait { set_context 'NATIVE_APP' }
-    wait { current_context.must_equal 'NATIVE_APP' }
-  end
-end

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

@@ -1,71 +0,0 @@
-# rake android[device/touch_actions]
-describe 'device/touch_actions' do
-  def swipe_till_text_visible(seen_text)
-    start_x = window_size[:width] / 2
-    start_y = window_size[:height] / 2
-    wait(60) do
-      # rubocop:disable Metrics/LineLength
-      # Example for Android's log
-      # [0] pry(#<device/touch_actions>)> swipe start_x: start_x, start_y: start_y, end_x: start_y, end_y: start_y - 100
-      # [HTTP] --> POST /wd/hub/session/9baa18bf-a19b-4654-be4a-d0db0334bbc0/touch/perform {"actions":[{"action":"press","options":{"x":600,"y":919}},{"action":"wait","options":{"ms":200}},{"action":"moveTo","options":{"x":600,"y":819}},{"action":"release"}]}
-      # [debug] [MJSONWP] Calling AppiumDriver.performTouch() with args: [[{"action":"press","options":{"x":600,"y":919}},{"action":"wait","options":{"ms":200}},{"action":"moveTo","options":{"x":600,"y":819}},{"action":"release"}],"9baa18bf-a19b-4654-be4a-d0db0334bbc0"]
-      # [debug] [AndroidBootstrap] Sending command to android: {"cmd":"action","action":"swipe","params":{"startX":600,"startY":919,"endX":600,"endY":819,"steps":6}}
-      # [AndroidBootstrap] [BOOTSTRAP LOG] [debug] Got data from client: {"cmd":"action","action":"swipe","params":{"startX":600,"startY":919,"endX":600,"endY":819,"steps":6}}
-      # [AndroidBootstrap] [BOOTSTRAP LOG] [debug] Got command of type ACTION
-      # [AndroidBootstrap] [BOOTSTRAP LOG] [debug] Got command action: swipe
-      # [AndroidBootstrap] [BOOTSTRAP LOG] [debug] Display bounds: [0,0][1200,1838]
-      # [AndroidBootstrap] [BOOTSTRAP LOG] [debug] Display bounds: [0,0][1200,1838]
-      # [AndroidBootstrap] [BOOTSTRAP LOG] [debug] Swiping from [x=600.0, y=919.0] to [x=600.0, y=819.0] with steps: 6
-      # [debug] [AndroidBootstrap] Received command result from bootstrap
-      # rubocop:enable Metrics/LineLength
-      swipe start_x: start_x, start_y: start_y, end_x: start_x, end_y: start_y - 100
-      text(seen_text).displayed?
-    end
-  end
-
-  t 'swipe_coordinates_end_x_end_y' do
-    s = Appium::TouchAction.new.swipe_coordinates(end_x: 1, end_y: 2)
-    s[:offset_x].must_equal 1
-    s[:offset_y].must_equal 2
-  end
-
-  t 'swipe_coordinates_end_x' do
-    s = Appium::TouchAction.new.swipe_coordinates(end_x: 1)
-    s[:offset_x].must_equal 1
-    s[:offset_y].must_equal 0
-  end
-
-  t 'swipe_coordinates_end_y' do
-    s = Appium::TouchAction.new.swipe_coordinates(end_y: 1)
-    s[:offset_x].must_equal 0
-    s[:offset_y].must_equal 1
-  end
-
-  t 'swipe_coordinates_offset' do
-    s = Appium::TouchAction.new.swipe_coordinates
-    s[:offset_x].must_equal 0
-    s[:offset_y].must_equal 0
-  end
-
-  t 'swipe_default_duration' do
-    swipe_till_text_visible('views')
-    text('views').click
-    wait_true do
-      text('animation').displayed?
-    end
-    text('animation').text.must_equal 'Animation'
-    swipe_till_text_visible('lists')
-  end
-end
-
-# TODO: write tests
-#
-# move_to
-# long_press
-# press
-# release
-# tap
-# wait
-# swipe
-# perform
-# cancel

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

@@ -1,280 +0,0 @@
-# rubocop:disable Lint/RescueException
-
-# rake android[driver]
-describe 'driver' do
-  def sauce?
-    ENV['UPLOAD_FILE'] && ENV['SAUCE_USERNAME']
-  end
-
-  t 'load_settings' do
-    appium_txt = File.join(Dir.pwd, 'appium.txt')
-    parsed   = Appium.load_settings file: appium_txt, verbose: true
-    apk_name = File.basename parsed[:caps][:app]
-    assert_equal apk_name, 'api.apk'
-  end
-
-  describe 'Appium::Driver attributes' do
-    t 'no_wait' do
-      no_wait
-      proc { button('zz') }.must_raise Selenium::WebDriver::Error::NoSuchElementError
-      set_wait
-    end
-
-    # attr_reader :default_wait, :app_path, :app_name, :selendroid,
-    #            :app_package, :app_activity, :app_wait_activity,
-    #            :sauce_username, :sauce_access_key, :port, :os, :debug
-    t 'default_wait attr' do
-      set_wait 1
-      default_wait.must_equal 1
-      set_wait # restore default
-    end
-
-    t 'app_path attr' do
-      apk_name = File.basename driver_attributes[:caps][:app]
-      apk_name.must_equal 'api.apk'
-    end
-
-    t 'verify Appium::Driver::Capabilities.init_caps_for_appium' do
-      expected_app = File.absolute_path('api.apk')
-      caps = ::Appium::Driver::Capabilities.init_caps_for_appium(platformName: 'Android',
-                                                                 app:          expected_app,
-                                                                 appPackage:   'io.appium.android.apis',
-                                                                 appActivity:  '.ApiDemos',
-                                                                 deviceName:   'Nexus 7',
-                                                                 some_capability: 'some_capability')
-      caps_with_json = JSON.parse(caps.to_json)
-      caps_with_json['platformName'].must_equal 'Android'
-      caps_with_json['app'].must_equal expected_app
-      caps_with_json['appPackage'].must_equal 'io.appium.android.apis'
-      caps_with_json['appActivity'].must_equal '.ApiDemos'
-      caps_with_json['deviceName'].must_equal 'Nexus 7'
-      caps_with_json['someCapability'].must_equal 'some_capability'
-
-      caps[:platformName].must_equal 'Android'
-      caps[:app].must_equal expected_app
-      caps[:appPackage].must_equal 'io.appium.android.apis'
-      caps[:appActivity].must_equal '.ApiDemos'
-      caps[:deviceName].must_equal 'Nexus 7'
-      caps[:some_capability].must_equal 'some_capability'
-    end
-
-    t 'verify all attributes' do
-      actual                = driver_attributes
-      caps_app_for_teardown = actual[:caps][:app]
-      expected_app = File.absolute_path('api.apk')
-
-      expected            = { automation_name:   nil,
-                              custom_url:       false,
-                              export_session:   false,
-                              default_wait:     1,
-                              sauce_username:   nil,
-                              sauce_access_key: nil,
-                              sauce_endpoint:   'ondemand.saucelabs.com:443/wd/hub',
-                              port:             4723,
-                              device:           :android,
-                              debug:            true,
-                              listener:         nil,
-                              wait_timeout:     30,    # default
-                              wait_interval:    0.5 }  # default
-
-      # actual[:caps].to_json send to Appium server
-      caps_with_json = JSON.parse(actual[:caps].to_json)
-      caps_with_json['platformName'].must_equal 'android'
-      caps_with_json['app'].must_equal expected_app
-      caps_with_json['appPackage'].must_equal 'io.appium.android.apis'
-      caps_with_json['appActivity'].must_equal '.ApiDemos'
-      caps_with_json['deviceName'].must_equal 'Nexus 7'
-      caps_with_json['someCapability'].must_equal 'some_capability'
-
-      actual[:caps][:platformName].must_equal 'android'
-      actual[:caps][:app].must_equal expected_app
-      actual[:caps][:appPackage].must_equal 'io.appium.android.apis'
-      actual[:caps][:appActivity].must_equal '.ApiDemos'
-      actual[:caps][:deviceName].must_equal 'Nexus 7'
-      actual[:caps][:some_capability].must_equal 'some_capability'
-
-      dup_actual = actual.dup
-      dup_actual.delete(:caps)
-
-      if dup_actual != expected
-        diff    = HashDiff.diff expected, actual
-        diff    = "diff (expected, actual):\n#{diff}"
-
-        actual[:caps][:app] = caps_app_for_teardown
-        # 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}"
-        raise message
-      end
-    end
-
-    t 'default timeout for http client' do
-      http_client.open_timeout.must_equal 999_999
-      http_client.read_timeout.must_equal 999_999
-    end
-  end
-
-  describe 'Appium::Driver' do
-    t '$driver.class' do
-      $driver.class.must_equal Appium::Driver
-    end
-
-    t 'absolute_app_path' do
-      def absolute_app_path(path)
-        $driver.class.absolute_app_path(caps: { app: path })
-      end
-
-      def validate_path(path)
-        absolute_app_path(path).must_equal path
-      end
-
-      validate_path 'sauce-storage:some_storage_suffix'
-      validate_path 'http://www.saucelabs.com'
-
-      # fake real paths for osx/windows.
-      FakeFS.activate!
-
-      osx_existing_path = '/Users/user/myapp.app'
-      FileUtils.mkdir_p osx_existing_path
-      validate_path osx_existing_path
-
-      # TODO: FakeFS fails on Windows paths due to the drive letters.
-      # Look into how opscode/chef tests this.
-      # windows_existing_path = "C:\\Program Files\\myapp.apk"
-      # FileUtils.mkdir_p windows_existing_path
-      # validate_path windows_existing_path
-
-      FakeFS.deactivate!
-
-      # bundle id test
-      validate_path 'my.bundle.id'
-
-      # relative path test
-      relative_path = File.join __FILE__, ('..' + File::SEPARATOR) * 4, 'api.apk'
-      expected_path = File.expand_path relative_path
-
-      absolute_app_path(relative_path).must_equal expected_path
-
-      # invalid path test
-      invalid_path_errors = false
-      begin
-        absolute_app_path('../../does_not_exist.apk')
-      rescue Exception
-        invalid_path_errors = true
-      ensure
-        invalid_path_errors.must_equal true
-      end
-    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 sauce?
-        server_version.must_match 'Sauce OnDemand'
-      else
-        server_version.must_match(/(\d+)\.(\d+).(\d+)/)
-      end
-    end
-
-    t 'client_version' do
-      client_version = appium_client_version
-      expected = { version: ::Appium::VERSION }
-      client_version.must_equal expected
-    end
-
-    # Skip:
-    #   ios_capabilities # save for iOS tests
-    #   absolute_app_path # tested already by starting the driver for this test
-    #   server_url # sauce labs only
-
-    t 'set_immediate_value' do
-      wait { find('app').click }
-      wait { find('activity').click }
-      wait { find('custom title').click }
-
-      message = 'hello'
-
-      wait do
-        elem = textfield(1)
-        elem.clear
-        set_immediate_value(elem, message)
-        elem.text.must_equal message
-      end
-    end
-
-    t 'restart' do
-      set_wait 1 # ensure wait is 1 before we restart.
-      restart
-      current_activity.must_equal '.ApiDemos'
-    end
-
-    t 'driver' do
-      driver.browser.must_be_empty
-    end
-
-    # Skip:
-    #   screenshot   # this is slow and already tested by Appium
-    #   driver_quit  # tested by restart
-    #   start_driver # tested by restart
-    #   no_wait  # posts value to server, it's not stored locally
-    #   set_wait # posts value to server, it's not stored locally
-    #   execute_script # 'mobile: ' is deprecated and plain execute_script unsupported
-
-    t 'default_wait' do
-      set_wait 1
-      default_wait.must_equal 1
-    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 elements
-    t 'find_elements' do
-      wait do
-        find_elements(:class_name, 'android.widget.TextView').length.must_equal 13
-      end
-    end
-
-    # any element
-    t 'find_element' do
-      wait do
-        find_element(:class_name, 'android.widget.TextView').class.must_equal Selenium::WebDriver::Element
-      end
-    end
-
-    # simple integration sanity test to check for unexpected exceptions
-    t 'set_location' do
-      begin
-        set_location latitude: 55, longitude: -72, altitude: 33
-      rescue Selenium::WebDriver::Error::UnknownError => e
-        # on android this method is expected to raise with this message when running
-        # on a regular device, or on genymotion.
-        # error could be many messages, including:
-        # ERROR running Appium command: port should be a number or string
-        # ERROR running Appium command: port should be > 0 and < 65536
-        raise unless e.message.include?('ERROR running Appium command: port should be')
-      end
-    end
-
-    # settings
-    t 'get settings' do
-      get_settings.wont_be_nil
-    end
-
-    t 'update settings' do
-      update_settings cyberdelia: 'open'
-      get_settings['cyberdelia'].must_equal 'open'
-    end
-
-    # Skip: x # x is only used in Pry
-  end
-end