Chapters 1-6 of the appium bootcamp, with a few of my own twists

Author: Jason Hagglund

.gitignore

@@ -0,0 +1,43 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Ruby template
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+.ruby-gemset
+.ruby-version
+
+.idea
+
+.DS_Store

Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+gem 'appium_lib'
+gem 'appium_console'
+gem 'rake'
+gem 'rspec'
+gem 'sauce_whisk'

Gemfile.lock

@@ -0,0 +1,92 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    appium_console (1.0.3)
+      appium_lib (>= 1.0.0)
+      bond (~> 0.5.0)
+      pry (~> 0.9.12.5)
+      spec (>= 5.3.3)
+    appium_lib (6.0.0)
+      awesome_print (~> 1.6, >= 1.6.0)
+      json (~> 1.8, >= 1.8.1)
+      nokogiri (~> 1.6.3.1)
+      selenium-webdriver (~> 2.41, >= 2.41.0)
+      toml (~> 0.0, >= 0.0.4)
+    awesome_print (1.6.1)
+    blankslate (2.1.2.4)
+    bond (0.5.1)
+    bond (0.5.1-java)
+    childprocess (0.5.5)
+      ffi (~> 1.0, >= 1.0.11)
+    chronic_duration (0.10.6)
+      numerizer (~> 0.1.1)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    ffi (1.9.8-java)
+    json (1.8.2)
+    json (1.8.2-java)
+    method_source (0.8.2)
+    mime-types (2.4.3)
+    mini_portile (0.6.0)
+    multi_json (1.11.0)
+    netrc (0.10.3)
+    nokogiri (1.6.3.1)
+      mini_portile (= 0.6.0)
+    nokogiri (1.6.3.1-java)
+    numerizer (0.1.1)
+    parslet (1.5.0)
+      blankslate (~> 2.0)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry (0.9.12.6-java)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+      spoon (~> 0.0)
+    rake (10.4.2)
+    rest-client (1.7.3)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.2)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    rubyzip (1.1.7)
+    sauce_whisk (0.0.17)
+      json (~> 1.8.1)
+      rest-client (~> 1.7.1)
+    selenium-webdriver (2.45.0)
+      childprocess (~> 0.5)
+      multi_json (~> 1.0)
+      rubyzip (~> 1.0)
+      websocket (~> 1.0)
+    slop (3.6.0)
+    spec (5.3.4)
+      chronic_duration (~> 0.10.2)
+    spoon (0.0.4)
+      ffi
+    toml (0.1.2)
+      parslet (~> 1.5.0)
+    websocket (1.2.1)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  appium_console
+  appium_lib
+  rake
+  rspec
+  sauce_whisk

Rakefile

@@ -0,0 +1,19 @@
+desc 'Run iOS tests'
+task :ios , :location do |t, args|
+  location_helper args[:location]
+  Dir.chdir 'iOS'
+  exec 'rspec'
+end
+
+desc 'Run Android tests'
+task :android, :location do |t, args|
+  location_helper args[:location]
+  Dir.chdir 'android'
+  exec 'rspec'
+end
+
+def location_helper(location)
+  if location != 'sauce'
+    ENV['SAUCE_USERNAME'], ENV['SAUCE_ACCESS_KEY'] = nil, nil
+  end
+end

android/.pryrc

@@ -0,0 +1,3 @@
+Pry.commands.alias_command 'c', 'continue'
+Pry.commands.alias_command 's', 'step'
+Pry.commands.alias_command 'n', 'next'

android/.rspec

@@ -0,0 +1 @@
+--color

android/appium.txt

@@ -0,0 +1,10 @@
+[caps]
+appium-version = "1.3.7"
+platformName = "Android"
+platformVersion = "5.0"
+app = "sample_apps/api.apk"
+deviceName = "Android"
+avd = "training"
+
+[appium_lib]
+require = ["./spec/requires.rb"]

android/pages/home.rb

@@ -0,0 +1,21 @@
+module Pages
+  module Home
+    class << self
+
+      def first_cell
+        @found_cell = wait { text 2 }
+        self
+      end
+
+      def click
+        @found_cell.click
+      end
+    end
+  end
+end
+
+module Kernel
+  def home
+    Pages::Home
+  end
+end

android/pages/inner_screen.rb

@@ -0,0 +1,16 @@
+module Pages
+  module InnerScreen
+    class << self
+
+      def has_text?(text)
+        wait { find_exact text }
+      end
+    end
+  end
+end
+
+module Kernel
+  def inner_screen
+    Pages::InnerScreen
+  end
+end

android/sample_apps/api.apk

@@ -0,0 +1,9 @@
+require_relative 'requires'
+
+describe 'Home Screen Navigation' do
+
+  it 'First cell' do
+    home.first_cell.click
+    inner_screen.has_text? 'Accessibility Node Provider'
+  end
+end

android/spec/navigation_spec.rb

@@ -0,0 +1,3 @@
+require_relative 'spec_helper'
+require_relative '../pages/home'
+require_relative '../pages/inner_screen'

android/spec/requires.rb

@@ -0,0 +1,53 @@
+require 'rspec'
+require 'appium_lib'
+require 'sauce_whisk'
+require 'pry'
+require_relative '../pages/home'
+require_relative '../pages/inner_screen'
+
+def using_sauce?
+  user = ENV['SAUCE_USERNAME']
+  key = ENV['SAUCE_ACCESS_KEY']
+  user && !user.empty? && key && !key.empty?
+end
+
+def upload_app
+  storage = SauceWhisk::Storage.new
+  app = @caps[:caps][:app]
+  storage.upload app
+  @caps[:caps][:app] = "sauce-storage:#{File.basename(app)}"
+end
+
+def setup_driver
+  return if $driver
+  appium_txt = File.join(Dir.pwd, 'appium.txt')
+  @caps = Appium.load_appium_txt file: appium_txt
+  if using_sauce?
+    upload_app
+    @caps[:caps].delete :avd
+  end
+  Appium::Driver.new(@caps)
+end
+
+def promote_methods
+  Appium.promote_singleton_appium_methods Pages
+  Appium.promote_appium_methods RSpec::Core::ExampleGroup
+end
+
+setup_driver
+promote_methods
+
+RSpec.configure do |config|
+
+  config.before(:each) do |example|
+    $driver.caps[:name] = example.metadata[:full_description] if using_sauce?
+    $driver.start_driver
+  end
+
+  config.after(:each) do |example|
+    if using_sauce?
+      SauceWhisk::Jobs.change_status($driver.driver.session_id, example.exception.nil?)
+    end
+    driver_quit
+  end
+end

android/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+Pry.commands.alias_command 'c', 'continue'
+Pry.commands.alias_command 's', 'step'
+Pry.commands.alias_command 'n', 'next'

iOS/.pryrc

@@ -0,0 +1 @@
+--color

iOS/.rspec

@@ -0,0 +1,9 @@
+[caps]
+appium-version = "1.3.7"
+platformName = "ios"
+platformVersion = "8.2"
+app = "sample_apps/UICatalog.app.zip"
+deviceName = "iPhone 5s"
+
+[appium_lib]
+require = ["./spec/requires.rb"]

iOS/appium.txt

@@ -0,0 +1,25 @@
+module Pages
+  module Home
+    class << self
+
+      def first_cell
+        @found_cell = wait { text 2 }
+        self
+      end
+
+      def title
+        @found_cell.name.split(',').first
+      end
+
+      def click
+        @found_cell.click
+      end
+    end
+  end
+end
+
+module Kernel
+  def home
+    Pages::Home
+  end
+end

iOS/pages/home.rb

@@ -0,0 +1,16 @@
+module Pages
+  module InnerScreen
+    class << self
+
+      def has_text?(text)
+        wait { text_exact text }
+      end
+    end
+  end
+end
+
+module Kernel
+  def inner_screen
+    Pages::InnerScreen
+  end
+end

iOS/pages/inner_screen.rb

@@ -0,0 +1,10 @@
+require_relative 'requires'
+
+describe 'Home Screen Navigation' do
+
+  it 'First cell' do
+    cell_title = home.first_cell.title
+    home.first_cell.click
+    inner_screen.has_text? cell_title
+  end
+end

iOS/sample_apps/UICatalog.app.zip

@@ -0,0 +1,3 @@
+require_relative 'spec_helper'
+require_relative '../pages/home'
+require_relative '../pages/inner_screen'