appium_lib_core 5.1.0 → 5.2.0

data/.rubocop.yml

@@ -1,152 +0,0 @@
-AllCops:
-  TargetRubyVersion: 2.6
-Layout/LineLength:
-  Max: 128
-Layout/RescueEnsureAlignment:
-  Enabled: false
-Layout/EmptyLinesAroundAttributeAccessor:
-  Enabled: false
-Layout/EmptyLineBetweenDefs:
-  Enabled: false
-Layout/HashAlignment:
-  Enabled: false
-Metrics/MethodLength:
-  Enabled: false
-Metrics/ModuleLength:
-  Enabled: false
-Metrics/ClassLength:
-  Enabled: false
-Metrics/AbcSize:
-  Enabled: false
-Metrics/CyclomaticComplexity:
-  Max: 14
-Metrics/PerceivedComplexity:
-  Max: 14
-Metrics/ParameterLists:
-  Enabled: false
-Lint/NestedMethodDefinition:
-  Enabled: false
-Style/ZeroLengthPredicate:
-  Enabled: false
-Style/Documentation:
-  Enabled: false
-Style/CommentedKeyword:
-  Enabled: false
-Style/PercentLiteralDelimiters:
-  Enabled: false
-Style/SymbolArray:
-  Enabled: false
-Style/UnpackFirst:
-  Enabled: false
-Naming/AccessorMethodName:
-  Enabled: false
-Naming/MemoizedInstanceVariableName:
-  Enabled: true
-  Exclude:
-    - test/**/*
-Naming/RescuedExceptionsVariableName:
-  Enabled: false
-Style/CaseLikeIf:
-  Enabled: false
-Style/RedundantRegexpEscape:
-  Enabled: false
-Style/OptionalBooleanParameter:
-  Enabled: false
-Style/ExplicitBlockArgument:
-  Enabled: false
-Style/KeywordParametersOrder:
-  Enabled: false
-Gemspec/DateAssignment:
-  Enabled: true
-Gemspec/RequireMFA:
-  Enabled: true
-Layout/LineEndStringConcatenationIndentation:
-  Enabled: true
-Layout/SpaceBeforeBrackets:
-  Enabled: true
-Lint/AmbiguousAssignment:
-  Enabled: true
-Lint/AmbiguousOperatorPrecedence:
-  Enabled: false
-Lint/AmbiguousRange:
-  Enabled: true
-Lint/DeprecatedConstants:
-  Enabled: true
-Lint/DuplicateBranch:
-  Enabled: true
-Lint/DuplicateRegexpCharacterClassElement:
-  Enabled: true
-Lint/EmptyBlock:
-  Enabled: true
-Lint/EmptyClass:
-  Enabled: true
-Lint/EmptyInPattern:
-  Enabled: true
-Lint/IncompatibleIoSelectWithFiberScheduler:
-  Enabled: true
-Lint/LambdaWithoutLiteralBlock:
-  Enabled: true
-Lint/NoReturnInBeginEndBlocks:
-  Enabled: true
-Lint/NumberedParameterAssignment:
-  Enabled: true
-Lint/OrAssignmentToConstant:
-  Enabled: true
-Lint/RedundantDirGlobSort:
-  Enabled: true
-Lint/RequireRelativeSelfPath:
-  Enabled: true
-Lint/SymbolConversion:
-  Enabled: true
-Lint/ToEnumArguments:
-  Enabled: true
-Lint/TripleQuotes:
-  Enabled: true
-Lint/UnexpectedBlockArity:
-  Enabled: true
-Lint/UnmodifiedReduceAccumulator:
-  Enabled: true
-Lint/UselessRuby2Keywords:
-  Enabled: true
-Security/IoMethods:
-  Enabled: true
-Style/ArgumentsForwarding:
-  Enabled: true
-Style/CollectionCompact:
-  Enabled: true
-Style/DocumentDynamicEvalDefinition:
-  Enabled: true
-Style/EndlessMethod:
-  Enabled: true
-Style/HashConversion:
-  Enabled: true
-Style/HashExcept:
-  Enabled: true
-Style/IfWithBooleanLiteralBranches:
-  Enabled: true
-Style/InPatternThen:
-  Enabled: true
-Style/MultilineInPatternThen:
-  Enabled: true
-Style/NegatedIfElseCondition:
-  Enabled: true
-Style/NilLambda:
-  Enabled: true
-Style/NumberedParameters:
-  Enabled: true
-Style/NumberedParametersLimit:
-  Enabled: true
-Style/QuotedSymbols:
-  Enabled: true
-Style/RedundantArgument:
-  Enabled: true
-Style/RedundantSelfAssignmentBranch:
-  Enabled: true
-Style/SelectByRegexp:
-  Enabled: true
-Style/StringChars:
-  Enabled: true
-Style/SwapValues:
-  Enabled: true
-Style/OpenStructUse:
-  Enabled: true

data/azure-pipelines.yml

@@ -1,15 +0,0 @@
-# Ruby
-# Package your Ruby project.
-# Add steps that install rails, analyze code, save build artifacts, deploy, and more:
-# https://docs.microsoft.com/azure/devops/pipelines/languages/ruby
-jobs:
-  - template: ./ci-jobs/functional_test.yml
-
-# Runs tests nightly to make sure they works against appium@beta
-schedules:
-  - cron: "0 0 * * *"
-    displayName: Daily Nightly build (UTC)
-    branches:
-      include:
-        - master
-    always: true

data/ci-jobs/functional/android_setup.yml

@@ -1,3 +0,0 @@
-steps:
-- script: bash ci-jobs/functional/start-emulator.sh
-  displayName: Create and run Emulator

data/ci-jobs/functional/ios_setup.yml

@@ -1,7 +0,0 @@
-steps:
-- script: sudo xcode-select -s /Applications/Xcode_${{ parameters.xcodeVersion }}.app/Contents/Developer
-  displayName: Xcode Select ${{ parameters.xcodeVersion }}
-- script: xcrun simctl list
-  displayName: List Installed Simulators
-- script: defaults write com.apple.iphonesimulator PasteboardAutomaticSync -bool false
-  displayName: Disable pasteboard automatic sync

data/ci-jobs/functional/publish_test_result.yml

@@ -1,18 +0,0 @@
-steps:
-- task: PublishTestResults@2
-  condition: always()
-  inputs:
-    testResultsFiles: 'test/reports/TEST-AppiumLibCoreTest*.xml'
-    testRunTitle: '$(Agent.JobName)'
-- task: ArchiveFiles@2
-  condition: always()
-  inputs:
-    rootFolderOrFile: 'test/report'
-    archiveType: 'zip'
-    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
-    replaceExistingArchive: true
-- task: PublishBuildArtifacts@1
-  condition: always()
-  inputs:
-    pathtoPublish: '$(Build.ArtifactStagingDirectory)'
-    artifactName: '$(Agent.JobName)'

data/ci-jobs/functional/run_appium.yml

@@ -1,25 +0,0 @@
-steps:
-- task: NodeTool@0
-  inputs:
-    versionSpec: 12.x
-  displayName: Install Node 12.x
-- script: npm install -g appium@${APPIUM_VERSION}
-  displayName: Install appium beta
-- script: npm install -g mjpeg-consumer
-  displayName: Install MJPEG Consumer
-- script: npm list --depth 2 -g || echo 'ok'
-  displayName: Installed node dependencies
-- task: UseRubyVersion@0
-  inputs:
-    versionSpec: '3.0'
-- script: |
-    mkdir -p test/report
-    nohup appium --relaxed-security --log-timestamp --log-no-colors > test/report/appium.out 2>&1 &
-  displayName: Run Appium in background
-  env:
-    JAVA_HOME: $(JAVA_HOME_11_X64)
-    PATH: $(JAVA_HOME_11_X64)/bin:$(PATH)
-- script: |
-    gem install bundler;
-    bundle install --retry=3 --jobs=4 --path vendor/bundle;
-  displayName: Install Gems

data/ci-jobs/functional/start-emulator.sh

@@ -1,26 +0,0 @@
-#!/usr/bin/env bash
-
-# This script was copy-pasted from https://docs.microsoft.com/en-us/azure/devops/pipelines/languages/android?view=azure-devops#test-on-the-android-emulator
-# with some changes
-
-# Install AVD files
-declare -r emulator="system-images;android-${ANDROID_SDK_VERSION};google_apis;x86"
-echo "y" | ${ANDROID_HOME}/tools/bin/sdkmanager --install "$emulator"
-
-# Show a list of emulators
-${ANDROID_HOME}/tools/bin/avdmanager list
-
-# Create emulator
-echo "no" | ${ANDROID_HOME}/tools/bin/avdmanager create avd -d "Nexus 5X" -n testemulator -k "${emulator}" --force
-
-echo ${ANDROID_HOME}/emulator/emulator -list-avds
-
-echo "Starting emulator"
-
-# Start emulator in background
-nohup ${ANDROID_HOME}/emulator/emulator -avd testemulator -accel auto -no-boot-anim -gpu auto -no-snapshot > /dev/null 2>&1 &
-${ANDROID_HOME}/platform-tools/adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed | tr -d '\r') ]]; do sleep 1; done; input keyevent 82'
-
-${ANDROID_HOME}/platform-tools/adb devices
-
-echo "Emulator started"

data/ci-jobs/functional_test.yml

@@ -1,298 +0,0 @@
-# jobs for functional test
-parameters:
-  vmImage: 'macOS-10.15'
-  vmImageForIOS: 'macOS-10.15'
-  xcodeForIOS: 12.2
-  xcodeForTVOS: 12.2
-  androidSDK: 29  # API Level 30 emulators are more unstable than 29
-  appiumVersion: 'beta'
-  ignoreVersionSkip: true
-  CI: true
-
-
-jobs:
-  # Run unit tests on different Node versions
-  - job: func_test_ios_base
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/driver_test.rb,test/functional/ios/patch_test.rb
-      displayName: Run tests func_test_ios_base
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_webdriver1
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/webdriver/create_session_test.rb,test/functional/ios/webdriver/w3c_actions_test.rb
-      displayName: Run tests func_test_ios_webdriver1
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_webdriver2
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/webdriver/device_test.rb
-      displayName: Run tests func_test_ios_webdriver2
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_ios1
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/ios/device_test.rb
-      displayName: Run tests func_test_ios_ios1
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_ios2
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/ios/device_wda_attachment_test.rb,test/functional/ios/ios/search_context_test.rb
-      displayName: Run tests func_test_ios_ios2
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_ios3
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - script: brew install ffmpeg && brew tap wix/brew && brew install applesimutils
-      displayName: Install ffmpeg and applesimutils
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/ios/mjpeg_server_test.rb,test/functional/ios/ios/mobile_commands_test.rb
-      displayName: Run tests func_test_ios_ios3
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_tvos
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForTVOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/tv_driver_test.rb
-      displayName: Run tests func_test_ios_tvos
-    - template: ./functional/publish_test_result.yml
-
-# Skip since opencv4nodejs fails to install on the macOS instance
-#  - job: func_test_ios_opencv
-#    pool:
-#      vmImage: ${{ parameters.vmImageForIOS }}
-#    variables:
-#      CI: ${{ parameters.ci }}
-#      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-#      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-#    steps:
-#      - template: ./functional/ios_setup.yml
-#        parameters:
-#          xcodeVersion: ${{ parameters.xcodeForIOS }}
-#      - template: ./functional/run_appium.yml
-#      - script: npm install -g opencv4nodejs@5.1.0
-#        displayName: Install opencv4nodejs@5.1.0
-#      - script: bundle exec rake test:func:ios test/functional/ios/ios/image_comparison_test.rb
-#        displayName: Run tests
-#      - template: ./functional/publish_test_result.yml
-
-
-  - job: func_test_android_base
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-    - template: ./functional/android_setup.yml
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:android TESTS=test/functional/android/driver_test.rb,test/functional/android/patch_test.rb
-      displayName: Run tests func_test_android_base
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_webdriver
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/webdriver/create_session_test.rb,test/functional/android/webdriver/device_test.rb,test/functional/android/webdriver/w3c_actions_test.rb
-        displayName: Run tests func_test_android_webdriver
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_android1
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/device_test.rb
-        displayName: Run tests func_test_android_android1
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_android2
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/search_context_test.rb,test/functional/android/android/mjpeg_server_test.rb
-        displayName: Run tests func_test_android_android2
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_android3
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/device_data_test.rb
-        displayName: Run tests func_test_android_android3
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_mobile_command_espresso
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      AUTOMATION_NAME_DROID: espresso
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/mobile_commands_test.rb
-        displayName: Run tests func_test_android_mobile_command_espresso
-      - template: ./functional/publish_test_result.yml
-
-# Skip since opencv4nodejs fails to install on the macOS instance
-#  - job: func_test_android_opencv
-#    pool:
-#      vmImage: ${{ parameters.vmImage }}
-#    variables:
-#      CI: ${{ parameters.ci }}
-#      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-#      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-#      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-#    strategy:
-#      matrix:
-#        uiautomator2:
-#          AUTOMATION_NAME_DROID: 'uiautomator2'
-#        espresso:
-#          AUTOMATION_NAME_DROID: 'espresso'
-#    steps:
-#      - template: ./functional/android_setup.yml
-#      - template: ./functional/run_appium.yml
-#      - script: npm install -g opencv4nodejs@5.1.0
-#        displayName: Install opencv4nodejs@5.1.0
-#      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/image_comparison_test.rb
-#        displayName: Run tests func_test_android_opencv
-#      - template: ./functional/publish_test_result.yml

data/docs/mobile_command.md

@@ -1,34 +0,0 @@
-# Mobile Command
-
-Appium has `mobile:` command.
-We can invoke them via `execute_script` command with `mobile:` arguments.
-
-- root:
-    - https://github.com/appium/appium/blob/master/commands-yml/commands/mobile-command.yml
-- Android:
-    - https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/android
-- iOS:
-    - https://github.com/appium/appium/tree/master/docs/en/writing-running-appium/ios
-
-
-```ruby
-# Android shell : https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/android/android-shell.md
-args = { command: 'echo', args: 'list' }
-@driver.execute_script 'mobile: shell', args # Run `adb shell echo 'list'`
-
-# iOS performance : https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/ios/ios-xctest-performance.md
-args = { timeout: 60 * 1000, profileName: 'Activity Monitor' }
-@driver.execute_script 'mobile: startPerfRecord', args
-
-@driver.execute_script 'mobile: stopPerfRecord', { profileName: 'Activity Monitor' }
-```
-
-Mobile commands return their error messages. As a selenium client, it usually handles as unknown error.
-To handle it, we would recommend you to handle the error based on the error message.
-
-```ruby
-error = assert_raises ::Selenium::WebDriver::Error::UnknownError do
-  @driver.execute_script 'mobile: scrollToPage', { element: el.id, scrollToPage: -100 }
-end
-assert error.message.include? 'be a non-negative integer'
-```