appium_lib 6.0.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5ee9efbaa5fd39661d0f04c19166a319ce4b35d4
-  data.tar.gz: 64a681103bbef3049e6f5625eb33cb5261100897
+  metadata.gz: 153536702ca868791ca4c3172f16b930d353bf9c
+  data.tar.gz: 950e645ff01a061f5353655e26703e0d92f69086
 SHA512:
-  metadata.gz: 49e11eb8cb100fcbf9b063e2068a53673aab09db120111716cab54f39ac9858bb340bd9fdba3552b4a052c57d42447443f1fd4d6e89c380defbedbc339b4b812
-  data.tar.gz: c583f8ec7817165d3a2d1085356a6154b89db9c95280029c4a554d8b558c814c9c6b32f0e5eb9b44cbedb6f551f6963e65599f07b2af4220ab271c3b78e396d1
+  metadata.gz: 7be0973ccbe79716693065e2c4068d40f9f3811cc128af6fde909982a6e846f5855e4fe8e7ad3b6bbf6fd000b02ab874a0e795560d4b36c1f740072eb069ed9b
+  data.tar.gz: 6ec9bc433e1dbd7e6c4bc0b04772ef8f1e7dc384febf08b5b6b000a7cd9df9800ff5fc8eb2595499712bb9e0b0b1ab1b54ac0a5d2613e2232c890bc6f32e4595

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+*.lock

data/.rubocop.yml

@@ -0,0 +1,28 @@
+# Custom config for RuboCop static code analysis
+Metrics/LineLength:
+  Max: 125
+Metrics/MethodLength:
+  Enabled: false
+Metrics/ClassLength:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Enabled: false
+Metrics/PerceivedComplexity:
+  Enabled: false
+Metrics/AbcSize:
+  Enabled: false
+Style/Documentation:
+  Enabled: false
+Style/RegexpLiteral:
+  Enabled: false
+Style/ConstantName:
+  Enabled: false
+# blocked on https://github.com/appium/ruby_lib/issues/312
+Style/GlobalVars:
+  Enabled: false
+Style/AccessorMethodName:
+  Enabled: false
+Style/DoubleNegation:
+  Enabled: false
+Style/EachWithObject:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,10 @@
+sudo: false
+cache: bundler
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem update --remote bundler
+install:
+  - bundle install --retry=3
+script:
+  - bundle exec rake rubocop

data/Rakefile

@@ -3,6 +3,7 @@ require 'rubygems'
 require 'rake'
 require 'date'
 require 'posix/spawn'
+require 'rubocop/rake_task'
 
 # Defines gem name.
 def repo_name
@@ -226,4 +227,11 @@ end
 desc 'Remove non-ascii bytes'
 task :byte do
   remove_non_ascii
-end
+end
+
+desc 'Execute RuboCop static code analysis'
+RuboCop::RakeTask.new(:rubocop) do |t|
+  t.patterns = %w(lib ios_tests android_tests)
+  t.options = %w(-D)
+  t.fail_on_error = true
+end

data/android_tests/Gemfile

@@ -1,2 +1,2 @@
 source 'https://rubygems.org'
-gemspec path: File.expand_path('../../', __FILE__) # __dir__ fails on 1.9
+gemspec path: File.expand_path('../../', __FILE__) # __dir__ fails on 1.9

data/android_tests/Rakefile

@@ -1,22 +1,22 @@
 require 'rubygems'
 require 'rake'
+require 'rubocop/rake_task'
 
-task :default => :android
+task default: :android
 
 # Run sh and ignore exception
-def run_sh cmd
-  begin
-    sh cmd
-  rescue
-  end
+# rubocop:disable Lint/HandleExceptions
+def run_sh(cmd)
+  sh cmd
+rescue
 end
 
 # Run cmd. On failure run install and try again.
-def bash cmd
+def bash(cmd)
   sh cmd do |successful, result|
     # exitstatus 7 means bundle install failed
     # exitstatus 1 means the test failed
-    if !successful && result.exitstatus === 7
+    if !successful && result.exitstatus == 7
       Rake::Task['install'].execute
       run_sh cmd
     end
@@ -33,10 +33,10 @@ end
 
 # rake android['single_text_name']
 # rake android
-def run_android test_file=nil
+def run_android(test_file = nil)
   wait_for_valid_device
   cmd = 'bundle exec ruby ./lib/run.rb android'
-  cmd += %Q( "#{test_file}") if test_file
+  cmd += %( "#{test_file}") if test_file
   bash cmd
 end
 
@@ -46,16 +46,23 @@ end
 # Run all tests with:
 # rake android
 desc 'Run the Android tests'
-task :android, :args, :test_file do |args, test_file|
+task :android, :args, :test_file do |_args, test_file|
   run_android test_file[:args]
 end
 
 desc 'Run the Android tests without uninstalling'
-task :droid, :args, :test_file do |args, test_file|
+task :droid, :args, :test_file do |_args, test_file|
   run_android test_file[:args]
 end
 
 desc 'Run bundle install'
 task :install do
   sh 'bundle install'
-end
+end
+
+desc 'Execute RuboCop static code analysis'
+RuboCop::RakeTask.new(:rubocop) do |t|
+  t.patterns = %w(**/*.rb)
+  t.options = %w(-D)
+  t.fail_on_error = false
+end

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

@@ -45,4 +45,4 @@ describe 'android/element/alert' do
     # nav to start activity
     2.times { back }
   end
-end
+end

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

@@ -28,7 +28,7 @@ describe 'android/element/button' do
 
   t 'buttons' do
     exp = ['Zoom in', 'Modern zoom in', 'Thumbnail zoom']
-    wait { buttons('zoom').map { |e| e.text }.must_equal exp }
+    wait { buttons('zoom').map(&:text).must_equal exp }
     wait { buttons.length.must_equal 6 }
   end
 
@@ -49,4 +49,4 @@ describe 'android/element/button' do
   end
 
   t { after_last }
-end
+end

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

@@ -1,6 +1,5 @@
 # rake android['android/element/generic']
 describe 'android/element/generic' do
-
   def content
     'Content'
   end
@@ -45,4 +44,4 @@ describe 'android/element/generic' do
     # back to start activity
     back
   end
-end
+end

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

@@ -1,7 +1,6 @@
 # rake android['android/element/text']
 describe 'android/element/text' do
-
-  def must_raise_no_element &block
+  def must_raise_no_element(&block)
     proc { block.call }.must_raise Selenium::WebDriver::Error::NoSuchElementError
   end
 
@@ -33,4 +32,4 @@ describe 'android/element/text' do
   t 'texts_exact' do
     wait { texts_exact('API Demos').length.must_equal 1 }
   end
-end
+end

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

@@ -1,5 +1,5 @@
 describe 'android/element/textfield' do
-  def must_raise_no_element &block
+  def must_raise_no_element(&block)
     proc { block.call }.must_raise Selenium::WebDriver::Error::NoSuchElementError
   end
 
@@ -59,4 +59,4 @@ describe 'android/element/textfield' do
   end
 
   t { after_last }
-end
+end

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

@@ -1,3 +1,5 @@
+# rubocop:disable Metrics/LineLength
+
 # rake android[android/helper]
 describe 'android/helper' do
   t 'tags' do
@@ -84,8 +86,8 @@ describe 'android/helper' do
       ['mFocusedApp=AppWindowToken{b40af858 token=Token{b3e2ce38 ActivityRecord{b3eb47d8 u0 io.appium.android.apis/.ApiDemos t6}}}',
        'io.appium.android.apis',
        '.ApiDemos'
-      # api 16 selendroid
       ],
+      # api 16 selendroid
       ['mFocusedApp=AppWindowToken{4157a2c8 token=Token{41582628 ActivityRecord{415821f0 com.android.launcher/com.android.launcher2.Launcher}}}',
        'com.android.launcher',
        'com.android.launcher2.Launcher'
@@ -94,10 +96,10 @@ describe 'android/helper' do
 
     expected.each do |line, package, activity|
       parsed = _parse_current_app_line(line)
-      raise "failed to parse #{line}" if parsed.nil?
+      fail "failed to parse #{line}" if parsed.nil?
       parsed.package.must_equal package
       parsed.activity.must_equal activity
       parsed.am_start.must_equal package + '/' + activity
     end
   end
-end
+end

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

@@ -9,7 +9,7 @@ describe 'android/patch.rb' do
     wait { first_textfield.type 'ok' }
     wait { first_textfield.text.must_equal 'ok' }
 
-    # todo: how to invoke random am start commands?
+    # TODO: how to invoke random am start commands?
     # nav to start activity
     # io.appium.android.apis/.ApiDemos
 
@@ -24,4 +24,4 @@ describe 'android/patch.rb' do
     back
     wait { find('app') }
   end
-end
+end

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

@@ -2,13 +2,13 @@
 describe 'common/device' do
   # Not yet implemented
   t 'shake' do
-    # todo: write test
+    # TODO: write test
   end
 
   t 'remove & install' do
-    # todo: write test
-    #remove 'com.example.android.apis'
-    #install ENV['APP_PATH']
+    # TODO: write test
+    # remove 'com.example.android.apis'
+    # install ENV['APP_PATH']
   end
 
   t 'background_app' do
@@ -24,8 +24,8 @@ describe 'common/device' do
     wait { current_activity.include?('Settings').must_equal true }
   end
 
-  t 'is_installed' do
-    wait { is_installed?('fake_app').must_equal false }
+  t 'installed' do
+    wait { app_installed?('fake_app').must_equal false }
   end
 
   t 'reset' do
@@ -33,6 +33,13 @@ describe 'common/device' do
     wait { text(1).text.must_equal 'API Demos' }
   end
 
+  t 'device_locked?' do
+    lock 5
+    wait { device_locked?.must_equal true }
+    press_keycode 82
+    wait { device_locked?.must_equal false }
+  end
+
   t 'close & launch' do
     close_app
     launch_app
@@ -43,10 +50,10 @@ describe 'common/device' do
   end
 
   t 'app_strings' do
-    wait_true { app_strings.has_key? 'activity_save_restore' }
+    wait_true { app_strings.key? 'activity_save_restore' }
   end
 
-  def must_return_element element
+  def must_return_element(element)
     element.class.must_equal Selenium::WebDriver::Element
   end
 
@@ -103,4 +110,4 @@ describe 'common/device' do
     data = pull_folder '/data/local/tmp'
     data.length.must_be :>, 100
   end
-end
+end

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

@@ -3,7 +3,7 @@ describe 'common/device_touchaction' do
   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
+      Appium::TouchAction.new.press(element: e, x: 0.5, y: 0.5).release(element: e).perform
     end
     wait { find_element(:name, 'Custom View') }
     back
@@ -13,6 +13,7 @@ describe 'common/device_touchaction' do
   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 }
     wait { !exists { text_exact 'NFC' } }
+    wait { text_exact 'Bouncing Balls' }
     back
     wait { text_exact 'NFC' }
   end
@@ -25,5 +26,7 @@ describe 'common/device_touchaction' do
       zoom 200
       pinch 75
     end
+    2.times { back }
+    wait { text_exact 'NFC' }
   end
-end
+end

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

@@ -6,4 +6,4 @@ describe 'common/element/window' do
       size.height.class.must_equal Fixnum
     end
   end
-end
+end

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

@@ -1,12 +1,10 @@
 describe 'common/helper' do
   wait_opts = { timeout: 0.2, interval: 0.2 } # max_wait, interval
 
-=begin
-There's no `must_not_raise` as the opposite of must_raise
+  # 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.
-=end
+  # 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
@@ -17,12 +15,12 @@ must_not_raise is a no-op.
     wait(wait_opts) { nil }
 
     # failed wait should error
-    proc { wait(wait_opts) { raise } }.must_raise Selenium::WebDriver::Error::TimeOutError
+    proc { wait(wait_opts) { fail } }.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
+    proc { wait(wait_opts) { fail NoMemoryError } }.must_raise Selenium::WebDriver::Error::TimeOutError
+    proc { wait(timeout: 0.2, interval: 0.0) { fail NoMemoryError } }.must_raise Selenium::WebDriver::Error::TimeOutError
 
     # invalid keys are rejected
     proc { wait(invalidkey: 2) { true } }.must_raise RuntimeError
@@ -33,8 +31,8 @@ must_not_raise is a no-op.
     ignore { true }
     ignore { false }
     ignore { nil }
-    ignore { raise }
-    ignore { raise NoMemoryError }
+    ignore { fail }
+    ignore { fail NoMemoryError }
   end
 
   # wait_true is a success unless the value is not true
@@ -47,12 +45,13 @@ must_not_raise is a no-op.
     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
+    proc { wait_true(wait_opts) { fail } }.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
+    proc { wait_true(wait_opts) { fail NoMemoryError } }.must_raise Selenium::WebDriver::Error::TimeOutError
+    proc { wait_true(timeout: 0.2, interval: 0.0) { fail NoMemoryError } }
+      .must_raise Selenium::WebDriver::Error::TimeOutError
 
     # invalid keys are rejected
     proc { wait_true(invalidkey: 2) { true } }.must_raise RuntimeError
@@ -72,7 +71,7 @@ must_not_raise is a no-op.
   end
 
   t 'session_id' do
-    wait { session_id.must_match /\h{8}-\h{4}-\h{4}-\h{4}-\h{12}/ }
+    wait { session_id.must_match(/\h{8}-\h{4}-\h{4}-\h{4}-\h{12}/) }
   end
 
   t 'xpath' do
@@ -110,4 +109,4 @@ must_not_raise is a no-op.
       get_source.class.must_equal String
     end
   end
-end
+end

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

@@ -1,11 +1,13 @@
-=begin
-  Skip:
-    status # status patches are already tested in driver.rb
-    raw_execute # debug output for Pry
-=end
+# 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
+  # 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
@@ -35,7 +37,7 @@ describe 'common/patch' do
       begin
         set_wait 0
         find_element(:id, 'ok')
-      rescue Exception => e;
+      rescue Exception => e
         value = e.message
       ensure
         set_wait 30
@@ -66,4 +68,4 @@ describe 'common/patch' do
       end
     end
   end
-end
+end