appium_lib 0.24.1 → 1.0.0

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

@@ -0,0 +1,35 @@
+# rake ios['ios/element/generic']
+describe 'ios/element/generic' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  def uibutton_text
+    'Buttons, Various uses of UIButton'
+  end
+
+  def verify element
+    element = element.first if element.is_a? Array
+    element.name.must_equal uibutton_text
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  t 'find' do
+    verify find 'tons'
+  end
+
+  t 'finds' do
+    verify finds 'tons'
+  end
+
+  t 'find_exact' do
+    verify find_exact uibutton_text
+  end
+
+  t 'finds_exact' do
+    verify finds_exact uibutton_text
+  end
+end

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

@@ -0,0 +1,54 @@
+# rake ios['ios/element/text']
+describe 'ios/element/text' do
+  def ui_catalog
+    'UICatalog'
+  end
+
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  t 'e_s_texts' do
+    e_s_texts.length.must_equal 13
+  end
+
+  t 'first_s_text' do
+    first_s_text.text.must_equal ui_catalog
+  end
+
+  t 'last_s_text' do
+    last_s_text.text.must_equal ''
+    last_s_text.name.must_equal 'Transitions, Shows UIViewAnimationTransitions'
+  end
+
+  t 's_text' do
+    s_text('mat').text.must_equal ''
+    s_text(1).text.must_equal ui_catalog
+    s_text('mat').name.must_equal 'Transitions, Shows UIViewAnimationTransitions'
+  end
+
+  t 's_texts' do
+    exp = ['Controls, Various uses of UIControl', 'Segments, Various uses of UISegmentedControl']
+    s_texts('trol').map { |e| e.name }.must_equal exp
+    s_texts('uses').length.must_equal 7
+  end
+
+  t 's_text_exact' do
+    # should fail
+    set_wait 0
+    act = begin; s_text_exact 'mos'; rescue; end
+    act.must_be_nil
+    set_wait
+
+    # should pass
+    s_text_exact(ui_catalog).text.must_equal ui_catalog
+  end
+
+  t 's_texts_exact' do
+    s_texts_exact('UICatalog').length.must_equal 1
+  end
+end

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

@@ -0,0 +1,123 @@
+# rake ios[ios/element/textfield]
+describe 'ios/element/textfield' do
+  def enter_text
+    '<enter text>'
+  end
+
+  def enter_password
+    '<enter password>'
+  end
+
+  def before_first
+    go_to_textfields
+  end
+
+  def after_last
+    set_wait 30
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  t 'textfield' do
+    textfield(1).text.must_equal(enter_text)
+    textfield(enter_text).text.must_equal(enter_text)
+    textfield('word').text.must_equal enter_password
+  end
+
+  t 'textfields' do
+    values = textfields('enter').map { |e| e.value }
+    values.include?('<enter text>').must_equal true
+    values.include?('<enter password>').must_equal true
+  end
+
+  t 'first_textfield' do
+    first_textfield.text.must_equal enter_text
+  end
+
+  t 'last_textfield' do
+    last_textfield.text.must_equal enter_password
+  end
+
+  t 'textfield_exact' do
+    textfield_exact(enter_password).text.must_equal enter_password
+  end
+
+  t 'textfields_exact' do
+    textfields_exact(enter_password).first.text.must_equal enter_password
+  end
+
+  t 'e_textfields' do
+    e_textfields.length.must_equal 4
+  end
+
+  def keyboard_exists?
+    !!ignore { wait_true(3) { execute_script 'au.mainApp().keyboard().type() !== "UIAElementNil"' } }
+  end
+
+  def keyboard_must_not_exist
+    keyboard_exists?.must_equal false
+  end
+
+  def keyboard_must_exist
+    keyboard_exists?.must_equal true
+  end
+
+  t 'textfield type' do
+    # Regular send keys triggers the keyboard and doesn't dismiss
+    keyboard_must_not_exist
+    textfield(1).send_keys 'ok'
+    keyboard_must_exist
+
+    # type will dismiss the keyboard
+    message = 'type test type'
+    textfield(1).type message
+    keyboard_must_not_exist
+    textfield(1).text.must_equal message
+  end
+
+  def must_raise_no_element &block
+    proc { block.call }.must_raise Selenium::WebDriver::Error::NoSuchElementError
+  end
+
+  # test textfield methods with no textfields
+
+  t 'leave textfields' do
+    set_wait 1
+    leave_textfields
+  end
+
+  t 'no textfield' do
+    must_raise_no_element { textfield(1) }
+    must_raise_no_element { textfield('does not exist') }
+  end
+
+  t 'no textfields' do
+    textfields('does not exist').length.must_equal 0
+  end
+
+  t 'no first_textfield' do
+    must_raise_no_element { first_textfield }
+  end
+
+  t 'no last_textfield' do
+    must_raise_no_element { last_textfield }
+  end
+
+  t 'no textfield_exact' do
+    must_raise_no_element { textfield_exact('does not exist') }
+  end
+
+  t 'no textfields_exact' do
+    textfields_exact('does not exist').length.must_equal 0
+  end
+
+  t 'no e_textfields' do
+    e_textfields.length.must_equal 0
+  end
+
+  t 'after_last' do
+    after_last
+  end
+end

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

@@ -0,0 +1,27 @@
+# rake ios[ios/helper]
+describe 'ios/helper' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  t 'ios_password' do
+    ios_password.must_equal '•'
+    ios_password(2).must_equal '•' * 2
+  end
+
+  # todo: t 'get_page' do
+
+  # t 'page' do # writes to std out
+
+  t 'source_window' do
+    source_window.length.must_equal 11
+  end
+
+  # todo: t 'page_window' do
+  # todo: t 'id' do
+  # todo: t 'ios_version' do
+end

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

@@ -0,0 +1,30 @@
+# rake ios[ios/patch]
+describe 'ios/patch' do
+  def before_first
+    screen.must_equal catalog
+    go_to_textfields
+  end
+
+  def after_last
+    leave_textfields
+  end
+
+  t 'before_first' do
+    before_first
+  end
+
+  # todo: test 'label'
+
+  t 'type' do
+    # nav to textfield
+    s_text('textfields').click
+
+    ele = first_textfield
+    ele.type 'ok'
+    ele.text.must_equal 'ok'
+  end
+
+  t 'after_last' do
+    after_last
+  end
+end

data/ios_tests/lib/run.rb

@@ -0,0 +1,106 @@
+require 'rubygems'
+require 'spec'
+require 'hashdiff'
+
+require_relative '../../lib/appium_lib'
+
+=begin
+Run all Android tests:
+  ruby run.rb android
+
+Run only the view album test:
+  ruby run.rb ios view_album
+=end
+
+# Sanity check
+a = OpenStruct.new x: 'ok'
+raise 'x issue' unless a.x == 'ok'
+
+# common methods
+def back_click(opts={})
+  opts        ||= {}
+  search_wait = opts.fetch(:wait, 60 * 1.7)
+  # iOS may have multiple 'back' buttons
+  # select the first displayed? back button.
+  wait(search_wait) do
+    button_exact('Back').click
+  end
+end
+
+def leave_textfields
+  back_click
+  screen.must_equal catalog
+end
+
+def go_to_textfields
+  screen.must_equal catalog
+  wait_true { s_text('textfield').click; screen == 'TextFields' } # wait for screen transition
+  screen.must_equal 'TextFields'
+end
+
+def screen
+  $driver.find_element(:class, 'UIANavigationBar').name
+end
+
+def catalog
+  'UICatalog'
+end
+
+##
+
+caps = Appium.load_appium_txt file: File.expand_path('..', __FILE__), verbose: true
+caps = caps.merge({ appium_lib: { debug: true, wait: 30 } })
+
+dir     = File.expand_path '..', __FILE__
+device  = ARGV[0].downcase.strip
+devices = %w[ android selendroid ios ]
+raise 'Expected android, selendroid or ios as first argument' unless devices.include? device
+
+one_test   = ARGV[1]
+test_dir   = "/#{device}/"
+
+caps[:app] = ENV['SAUCE_PATH'] if ENV['SAUCE_USERNAME'] && ENV['SAUCE_ACCESS_KEY']
+
+trace_files = []
+
+if one_test
+  unless File.exists? one_test
+    # ensure ext is .rb
+    one_test = File.join(File.dirname(one_test),
+                         File.basename(one_test, '.*') + '.rb')
+    one_test = File.join(dir, test_dir + 'specs/', one_test)
+  else
+    one_test = File.expand_path one_test
+  end
+  raise "\nTest #{one_test} does not exist.\n" unless File.exists?(one_test)
+  Appium::Driver.new(caps).start_driver
+  # require support (common.rb)
+  Dir.glob(File.join dir, test_dir + '/*.rb') do |test|
+    require test
+    trace_files << test
+  end
+  puts "Loading one test: #{one_test}"
+  require one_test
+  trace_files << one_test
+else
+  # require all
+  Dir.glob(File.join dir, test_dir + '**/*.rb') do |test|
+    # load all tests
+    trace_files << test
+    puts "  #{File.basename(test, '.*')}"
+    require test
+  end
+  Appium::Driver.new(caps).start_driver
+end
+
+trace_files.map! do |f|
+  f = File.expand_path f
+  # ensure all traced files end in .rb
+  f = File.join(File.dirname(f), File.basename(f, '.*') + '.rb')
+  f
+end
+
+# Exit after tests.
+Minitest.after_run { $driver.x if $driver }
+# Run Minitest. Provide test file array for tracing.
+Minitest.run_specs({ :trace => trace_files })

data/ios_tests/readme.md

@@ -0,0 +1,30 @@
+ruby_lib_ios
+=====================
+
+ruby_lib's iOS tests. Requires `Ruby 1.9.3` or better.
+
+- `rake install` Install gems required to run the tests.
+- `rake ios` Run all tests.
+- `rake` Run all the test. Same as `rake ios`
+- `rake ios['ios/element/generic']` Run a single test.
+- `arc` Opens the Appium Ruby Console (arc). Enables interactive testing.
+  - `gem install appium_console` if it's not installed already.
+
+`UICatalog6.1` is from [appium/appium](https://github.com/appium/appium/blob/master/assets/UICatalog6.1.app.zip)
+
+The tests are now run against `iPhone Simulator 7.0.3 (11B508)`
+
+#### Documentation
+
+- [Installing Appium on OS X](https://github.com/appium/ruby_console/blob/master/osx.md)
+- [Overview](https://github.com/appium/ruby_lib/blob/master/docs/docs.md) 
+- [iOS methods](https://github.com/appium/ruby_lib/blob/master/docs/ios_docs.md)
+- [Minitest Expectations](http://ruby-doc.org/stdlib-1.9.3/libdoc/minitest/spec/rdoc/MiniTest/Expectations.html)
+
+--
+
+```java
+Finished in 1 min 49 secs
+
+101 runs, 130 assertions, 0 failures, 0 errors, 0 skips
+```

data/ios_tests/upload/sauce_storage.rb

@@ -0,0 +1,64 @@
+=begin
+See docs @ http://saucelabs.com/docs/rest#storage
+
+s = SauceStorage.new username: 'my_user_name', key: '00', debug: true
+
+# or if you have  SAUCE_USERNAME and SAUCE_ACCESS_KEY in env already
+
+s = SauceStorage.new debug: true
+ 
+# list all files
+s.files
+ 
+# upload a file
+s.upload '/tmp/sauce/test.zip'
+ 
+> s.files
+=> [{"size"=>8,
+  "mtime"=>1367700857.1011374,
+  "name"=>"test.zip",
+  "md5"=>"d8064dccc0b399d37c73ffa9661a79b6"}]
+> s.upload '/tmp/sauce/test.zip'
+Uploaded /tmp/sauce/test.zip
+ local_md5: 764efa883dda1e11db47671c4a3bbd9e
+remote_md5: 764efa883dda1e11db47671c4a3bbd9e
+=end
+require 'rubygems'
+require 'restclient'
+require 'json'
+ 
+class SauceStorage
+  attr_reader :username, :key, :url, :debug
+  def initialize opts
+    @username = opts.fetch :username, ENV['SAUCE_USERNAME']
+    @key = opts.fetch :key, ENV['SAUCE_ACCESS_KEY']
+    @url = "https://#{@username}:#{@key}@saucelabs.com/rest/v1/storage/#{@username}"
+    @debug = opts.fetch :debug, false
+  end
+ 
+  def upload file_path
+    file_name = File.basename file_path
+    file = File.new file_path
+    local_md5 = Digest::MD5.hexdigest File.read file_path
+    
+    self.files.each do |file|
+      if file['md5'] == local_md5
+        puts 'File already uploaded' if @debug
+        return true
+      end
+    end
+    
+    url = "#{@url}/#{file_name}?overwrite=plz"
+    remote_md5 = JSON.parse( RestClient.post url, file, content_type: 'application/octet-stream' )['md5']
+    if @debug
+      puts "Uploaded #{file_path}"
+      puts " local_md5: #{local_md5}"
+      puts "remote_md5: #{remote_md5}"
+    end
+    local_md5 == remote_md5
+  end
+ 
+  def files
+    JSON.parse( RestClient.get @url )['files']
+  end
+end