testcentricity 2.4.1 → 3.0.0

data/Rakefile

@@ -1 +1,63 @@
-require 'bundler/gem_tasks'
+require 'rubygems'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'rake'
+require 'rspec/core/rake_task'
+require 'simplecov'
+require 'yard'
+
+
+desc 'Run required specs'
+RSpec::Core::RakeTask.new(:required_specs) do |t|
+  t.rspec_opts = '--tag required'
+end
+
+
+desc 'Run web specs'
+RSpec::Core::RakeTask.new(:web_specs) do |t|
+  t.rspec_opts = '--tag web'
+end
+
+
+desc 'Run Cucumber features on iOS simulator'
+Cucumber::Rake::Task.new(:ios_sim) do |t|
+  t.profile = 'ios_sim'
+end
+
+
+desc 'Run Cucumber features on Android simulator'
+Cucumber::Rake::Task.new(:android_sim) do |t|
+  t.profile = 'android_sim'
+end
+
+
+desc 'Run required specs and Cucumber features'
+task required: [:required_specs, :android_sim, :ios_sim]
+
+
+desc 'Run all specs and Cucumber features'
+task all_specs: [:required_specs, :web_specs]
+
+
+desc 'Run all specs and Cucumber features'
+task all: [:required_specs, :web_specs, :android_sim, :ios_sim]
+
+
+desc 'Update HTML docs'
+YARD::Rake::YardocTask.new(:docs) do |t|
+  t.files = ['lib/**/*.rb']
+end
+
+
+desc 'Build and release new version'
+task :release do
+  version = TestCentricity::VERSION
+  puts "Releasing #{version}, y/n?"
+  exit(1) unless $stdin.gets.chomp == 'y'
+  sh 'gem build testcentricity.gemspec && ' \
+     "gem push testcentricity-#{version}.gem"
+end
+
+
+desc 'Update docs, build gem, and push to RubyGems'
+task ship_it: [:docs, :release]

data/config/cucumber.yml

@@ -0,0 +1,145 @@
+<% desktop = "--require features BROWSER_TILE=true BROWSER_SIZE=1300,1000 --publish-quiet" %>
+<% mobile  = "--require features --publish-quiet" %>
+<% reports = "--require features --format pretty --format html --out reports/test_results.html --format junit --out reports --format json --out reports/test_results.json" %>
+<% regression = "--tags '@regression and (not @wip and not @failing)' --require features" %>
+<% acceptance = "--tags '@bat and (not @wip and not @failing)' --require features" %>
+
+
+#==============
+# generic test context profiles
+#==============
+
+failing: --tags '@failing and not @wip'
+wip:     --tags '@wip and not @failing'
+dev:     --tags '@dev and (not @wip and not @failing)'
+regress: <%= regression %>
+bvt:     <%= acceptance %>
+
+
+#==============
+# test reporting profiles
+#==============
+
+report:   <%= reports %> REPORTING=true
+
+
+#==============
+# conditionally load Page and Screen Object implementations based on which target platform we're running on
+#==============
+
+ios:     PLATFORM=ios --tags @ios -r features/support/ios -e features/support/android
+android: PLATFORM=android --tags @android -r features/support/android -e features/support/ios
+web:     PLATFORM=web --tags @web -r features/support/web -e features/support/ios -e features/support/android
+
+
+#==============
+# target_test_environment profiles
+#==============
+
+local: TEST_ENVIRONMENT=LOCAL
+debug: DEBUG=true
+
+
+#==============
+# profiles for mobile device screen orientation
+#==============
+
+landscape: ORIENTATION=landscape
+portrait:  ORIENTATION=portrait
+
+
+#==============
+# profile to start Appium Server prior to running mobile browser tests on iOS or Android simulators or physical devices
+#==============
+run_appium: APPIUM_SERVER=run
+upload_app: UPLOAD_APP=true
+
+
+#==============
+# profiles for native iOS apps hosted within XCode iOS simulators
+# NOTE: Requires installation of XCode, iOS version specific target simulators, and Appium
+#==============
+
+appium_ios: WEB_BROWSER=appium --profile ios AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="iOS" NEW_COMMAND_TIMEOUT="30" <%= mobile %>
+app_ios_14: --profile appium_ios APP_VERSION="14.5"
+app_ios_15: --profile appium_ios APP_VERSION="15.4"
+
+iphone_12PM_14_sim: --profile app_ios_14 DEVICE_TYPE=phone APP_DEVICE="iPhone 12 Pro Max"
+iphone_13PM_15_sim: --profile app_ios_15 DEVICE_TYPE=phone APP_DEVICE="iPhone 13 Pro Max"
+iphone_11_14_sim:   --profile app_ios_14 DEVICE_TYPE=phone APP_DEVICE="iPhone 11"
+ipad_pro_12_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)"
+ios_sim:            --profile iphone_13PM_15_sim --profile local --profile run_appium
+
+
+#==============
+# profiles for native Android apps hosted within Android Studio Android Virtual Device emulators
+# NOTE: Requires installation of Android Studio, Android version specific virtual device simulators, and Appium
+#==============
+
+appium_android:    WEB_BROWSER=appium --profile android AUTOMATION_ENGINE=UiAutomator2 APP_PLATFORM_NAME="Android" <%= mobile %>
+app_android_12:    --profile appium_android APP_VERSION="12.0"
+pixel_5_api31_sim: --profile app_android_12 DEVICE_TYPE=phone APP_DEVICE="Pixel_5_API_31"
+android_sim:       --profile pixel_5_api31_sim --profile local --profile run_appium
+
+
+#==============
+# profiles for remotely hosted devices on the BrowserStack service
+#==============
+
+browserstack: WEB_BROWSER=browserstack BS_USERNAME="<INSERT USER NAME HERE>" BS_AUTHKEY="<INSERT PASSWORD HERE>" TEST_CONTEXT="TestCentricity"
+
+# BrowserStack iOS real device native app profiles
+bs_ios:           --profile browserstack --profile ios BS_OS=ios <%= mobile %>
+bs_iphone:        --profile bs_ios DEVICE_TYPE=phone
+bs_iphone13PM_15: --profile bs_iphone BS_OS_VERSION="15" BS_DEVICE="iPhone 13 Pro Max"
+bs_iphone11_14:   --profile bs_iphone BS_OS_VERSION="14" BS_DEVICE="iPhone 11"
+
+# BrowserStack Android real device native app profiles
+bs_android: --profile browserstack --profile android BS_OS=android <%= mobile %>
+bs_pixel5:  --profile bs_android BS_DEVICE="Google Pixel 5" BS_OS_VERSION="12.0" DEVICE_TYPE=phone
+
+
+#==============
+# profiles for remotely hosted devices on the SauceLabs service
+#==============
+
+saucelabs: WEB_BROWSER=saucelabs SL_USERNAME="<INSERT USER NAME HERE>" SL_AUTHKEY="<INSERT PASSWORD HERE>" DATA_CENTER="us-west-1" AUTOMATE_PROJECT="TestCentricity - SauceLabs"
+
+# SauceLabs iOS real device native app profiles
+sl_ios:           --profile saucelabs --profile ios SL_OS=ios <%= mobile %>
+sl_iphone:        --profile sl_ios DEVICE_TYPE=phone
+sl_iphone13PM_15: --profile sl_iphone SL_DEVICE="iPhone 13 Pro Max Simulator" SL_OS_VERSION="15.4"
+
+# SauceLabs Android real device native app profiles
+sl_android: --profile saucelabs --profile android SL_OS=android <%= mobile %>
+sl_pixel5:  --profile sl_android SL_DEVICE="Google Pixel 5 GoogleAPI Emulator" SL_OS_VERSION="12.0" DEVICE_TYPE=phone
+
+
+#==============
+# profiles for remotely hosted devices on the TestingBot service
+#==============
+
+testingbot: WEB_BROWSER=testingbot TB_USERNAME="<INSERT USER NAME HERE>" TB_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TestCentricity - TestingBot"
+
+# TestingBot iOS real device native app profiles
+tb_ios:               --profile testingbot --profile ios TB_OS=iOS <%= mobile %>
+tb_iphone:            --profile tb_ios DEVICE_TYPE=phone
+tb_iphone11_14_dev:   --profile tb_iphone TB_OS_VERSION="14.0" TB_DEVICE="iPhone 11" REAL_DEVICE=true
+tb_iphone11_14_sim:   --profile tb_iphone TB_OS_VERSION="14.2" TB_DEVICE="iPhone 11"
+tb_iphone13PM_15_sim: --profile tb_iphone TB_OS_VERSION="15.4" TB_DEVICE="iPhone 13 Pro Max"
+
+# TestingBot Android real device native app profiles
+tb_android:    --profile testingbot --profile android TB_OS=Android <%= mobile %>
+tb_pixel_dev:  --profile tb_android TB_DEVICE="Pixel" TB_OS_VERSION="9.0" DEVICE_TYPE=phone REAL_DEVICE=true
+tb_pixel6_sim: --profile tb_android TB_DEVICE="Pixel 6" TB_OS_VERSION="12.0" DEVICE_TYPE=phone
+
+
+#==============
+# profiles for remotely hosted devices on the LambdaTest service
+#==============
+
+lambdatest: WEB_BROWSER=lambdatest LT_USERNAME="<INSERT USER NAME HERE>" LT_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TestCentricity - LambdaTest"
+
+# LambdaTest iOS real device native app profiles
+lt_ios:    --profile lambdatest --profile ios LT_OS=iOS <%= mobile %>
+lt_iphone: --profile lt_ios DEVICE_TYPE=phone

data/config/locales/en-US.yml

@@ -0,0 +1,56 @@
+# Localization file for English/U.S. locale.
+
+en-US:
+  time:
+    formats:
+      default: "%m/%d/%Y"
+      long: "%B %d, %Y"
+      short: "%b %d"
+      abbrev: "%b %d, %Y"
+      abbrev_month: "%b"
+      month_year: "%B %Y"
+  date:
+    abbr_day_names:
+    - Sun
+    - Mon
+    - Tue
+    - Wed
+    - Thu
+    - Fri
+    - Sat
+    abbr_month_names:
+    -
+    - Jan
+    - Feb
+    - Mar
+    - Apr
+    - May
+    - Jun
+    - Jul
+    - Aug
+    - Sep
+    - Oct
+    - Nov
+    - Dec
+    day_names:
+    - Sunday
+    - Monday
+    - Tuesday
+    - Wednesday
+    - Thursday
+    - Friday
+    - Saturday
+    month_names:
+    -
+    - January
+    - February
+    - March
+    - April
+    - May
+    - June
+    - July
+    - August
+    - September
+    - October
+    - November
+    - December

data/config/test_data/LOCAL_data.yml

@@ -0,0 +1,11 @@
+Form_data:
+  primary:
+    username: "Ignatius von Snicklefritz"
+    password: "T0p_Sekrit"
+    image_filename: "Wilder.jpg"
+    multi_select: "Selection Item 2"
+    drop_down_item: "Drop Down Item 5"
+    check1: true
+    check2: true
+    check3: false
+    radio_select: 2

data/config/test_data/data.yml

@@ -0,0 +1,10 @@
+# This section is populated with Environment data required to execute automated test suites on all supported environments
+Environments:
+  LOCAL:
+    DEEP_LINK_PREFIX: 'mydemoapprn'
+    IOS_BUNDLE_ID: 'com.saucelabs.mydemoapp.rn'
+    ANDROID_APP_ID: 'com.saucelabs.mydemoapp.rn'
+    IOS_APP_PATH: '/Users/Shared/Test_Apps/iOS/MyRNDemoApp.app'
+    IOS_IPA_PATH: '/Users/Shared/Test_Apps/iOS/iOS-Real-Device-MyRNDemoApp.1.3.0-162.ipa'
+    ANDROID_APK_PATH: '/Users/Shared/Test_Apps/Android/Android-MyDemoAppRN.1.2.0.build-231.apk'
+

data/features/deep_links.feature

@@ -0,0 +1,26 @@
+@mobile @ios @android @regression
+
+
+Feature:  App screen deep links
+  In order to ensure comprehensive support for native app deep links
+  As a developer of the TestCentricity gem
+  I expect to validate that app screens can be directly accessed with minimal UI interactions
+
+
+  Background:
+    Given I have launched the SauceLabs My Demo app
+
+
+  Scenario Outline:  Verify screens can be directly accessed via deep links
+    Given I am on the <start> screen
+    When I load the <destination> screen
+    Then I expect the <destination> screen to be correctly displayed
+
+    Examples:
+      |start    |destination        |
+      |Products |About              |
+      |Products |Login              |
+      |Products |Webview            |
+      |Products |Checkout - Address |
+      |Products |Checkout - Payment |
+      |About    |Products           |

data/features/login.feature

@@ -0,0 +1,30 @@
+@mobile @ios @android @regression
+
+
+Feature:  Login page
+  In order to ensure comprehensive support for native app login features
+  As a developer of the TestCentricity gem
+  I expect users to access the app only with valid login credentials
+
+
+  Background:
+    Given I have launched the SauceLabs My Demo app
+
+
+  Scenario:  Verify login with valid credentials
+    Given I am on the Login screen
+    When I enter user credentials with valid data
+    Then I expect the Checkout - Address screen to be correctly displayed
+
+
+  Scenario Outline:  Verify correct error states when using invalid credentials
+    Given I am on the Login screen
+    When I enter user credentials with <reason>
+    Then I expect an error to be displayed due to <reason>
+
+    Examples:
+      |reason         |
+      |no username    |
+      |no password    |
+      |locked account |
+      |invalid user   |

data/features/navigation.feature

@@ -0,0 +1,31 @@
+@mobile @ios @android @regression
+
+
+Feature:  Screen Navigation
+  In order to ensure comprehensive support for native app navigation features
+  As a developer of the TestCentricity gem
+  I expect to validate that app screens can be accessed via navigation controls
+
+
+  Background:
+    Given I have launched the SauceLabs My Demo app
+    And I am on the Products screen
+
+
+  Scenario:  Verify navigation menu can be invoked and is properly displayed
+    When I open the navigation menu
+    Then I expect the navigation menu to be correctly displayed
+    When I close the navigation menu
+    Then I expect the navigation menu to be hidden
+
+
+  Scenario Outline:  Verify screen navigation features
+    When I tap the <screen_name> navigation menu item
+    Then I expect the <screen_name> screen to be correctly displayed
+
+    Examples:
+      |screen_name    |
+      |About          |
+      |Login          |
+      |Webview        |
+      |SauceBot Video |

data/features/step_definitions/generic_steps.rb

@@ -0,0 +1,72 @@
+include TestCentricity
+
+
+Given(/^I have launched the SauceLabs My Demo app$/) do
+  # activate the app
+  AppiumConnect.launch_app
+end
+
+
+When(/^I (?:load|am on) the (.*) (?:page|screen)$/) do |screen_name|
+  # find and load the specified target page/screen
+  target_page = PageManager.find_page(screen_name)
+  target_page.load_page
+end
+
+
+When(/^I (?:click|tap) the ([^\"]*) navigation menu item$/) do |screen_name|
+  # find and navigate to the specified target page/screen
+  target_page = PageManager.find_page(screen_name)
+  target_page.navigate_to
+end
+
+
+Then(/^I expect the (.*) (?:page|screen) to be correctly displayed$/) do |screen_name|
+  # find and verify that the specified target page/screen is loaded
+  target_page = PageManager.find_page(screen_name)
+  target_page.verify_page_exists
+  # verify that target page/screen is correctly displayed
+  target_page.verify_page_ui
+end
+
+
+When(/^I enter user credentials with (.*)$/) do |reason|
+  case reason.gsub(/\s+/, '_').downcase.to_sym
+  when :valid_data
+    username = 'bob@example.com'
+    password = '10203040'
+  when :invalid_user
+    username = 'iggy.snicklefritz@example.com'
+    password = '10203040'
+  when :locked_account
+    username = 'alice@example.com'
+    password = '10203040'
+  when :no_username
+    password = '10203040'
+  when :no_password
+    username = 'bob@example.com'
+  else
+    raise "#{reason} is not a valid selector"
+  end
+  login_screen.login(username, password)
+end
+
+
+Then(/^I expect an error to be displayed due to (.*)$/) do |reason|
+  PageManager.current_page.verify_entry_error(reason)
+end
+
+
+When(/^I (.*) the navigation menu$/) do |action|
+  PageManager.current_page.nav_menu_action(action)
+end
+
+
+Then(/^I expect the navigation menu to be correctly displayed$/) do
+  PageManager.current_page.verify_nav_menu(state = :displayed)
+end
+
+
+Then(/^I expect the navigation menu to be hidden$/) do
+  PageManager.current_page.verify_nav_menu(state = :closed)
+end

data/features/support/android/screens/about_screen.rb

@@ -0,0 +1,11 @@
+class AboutScreen < BaseAppScreen
+  trait(:page_name)    { 'About' }
+  trait(:page_locator) { { accessibility_id: 'about screen' } }
+  trait(:page_url)     { 'about' }
+  trait(:navigator)    { nav_menu.open_about }
+
+  def verify_page_ui
+    super
+    verify_ui_states(header_label => { visible: true, caption: 'About' })
+  end
+end

data/features/support/android/screens/base_app_screen.rb

@@ -0,0 +1,29 @@
+class BaseAppScreen < TestCentricity::ScreenObject
+  include SharedBaseAppScreen
+
+  trait(:page_name) { 'Base App Screen' }
+
+  # Base App screen UI elements
+  buttons menu_button:   { accessibility_id: 'open menu' },
+          cart_button:   { accessibility_id: 'cart badge' }
+  labels  header_label:  { xpath: '//android.view.ViewGroup[@content-desc="container header"]/android.widget.TextView' },
+          cart_quantity: { xpath: '//android.view.ViewGroup[@content-desc="cart badge"]/android.widget.TextView' }
+  section :nav_menu,     NavMenu
+
+  def verify_page_ui
+    ui = {
+      menu_button => { visible: true, enabled: true },
+      cart_button => { visible: true, enabled: true }
+    }
+    verify_ui_states(ui)
+  end
+
+  def invoke_nav_menu
+    menu_button.click
+    nav_menu.wait_until_visible(3)
+  end
+
+  def open_cart
+    cart_button.click
+  end
+end

data/features/support/android/screens/checkout_address_screen.rb

@@ -0,0 +1,17 @@
+class CheckoutAddressScreen < BaseAppScreen
+  include SharedCheckoutAddressScreen
+
+  trait(:page_name)    { 'Checkout - Address' }
+  trait(:page_locator) { { accessibility_id: 'checkout address screen' } }
+  trait(:page_url)     { 'checkout-address' }
+
+  # Checkout Address screen UI elements
+  textfields fullname_field:     { accessibility_id: 'Full Name* input field' },
+             address1_field:     { accessibility_id: 'Address Line 1* input field' },
+             address2_field:     { accessibility_id: 'Address Line 2 input field' },
+             city_field:         { accessibility_id: 'City* input field' },
+             state_region_field: { accessibility_id: 'State/Region input field' },
+             zip_code_field:     { accessibility_id: 'Zip Code* input field' },
+             country_field:      { accessibility_id: 'Country* input field' }
+  button     :to_payment_button, { accessibility_id: 'To Payment button' }
+end

data/features/support/android/screens/checkout_payment_screen.rb

@@ -0,0 +1,22 @@
+class CheckoutPaymentScreen < BaseAppScreen
+  include SharedCheckoutPaymentScreen
+
+  trait(:page_name)    { 'Checkout - Payment' }
+  trait(:page_locator) { { accessibility_id: 'checkout payment screen' } }
+  trait(:page_url)     { 'checkout-payment' }
+
+  # Checkout Payment screen UI elements
+  textfields payee_name_field:     { xpath: '(//android.widget.EditText[@content-desc="Full Name* input field"])[1]' },
+             card_number_field:    { accessibility_id: 'Card Number* input field' },
+             expiration_field:     { accessibility_id: 'Expiration Date* input field' },
+             security_code_field:  { accessibility_id: 'Security Code* input field' },
+             recipient_name_field: { xpath: '(//android.widget.EditText[@content-desc="Full Name* input field"])[2]' },
+             address1_field:       { accessibility_id: 'Address Line 1* input field' },
+             address2_field:       { accessibility_id: 'Address Line 2 input field' },
+             city_field:           { accessibility_id: 'City* input field' },
+             state_region_field:   { accessibility_id: 'State/Region input field' },
+             zip_code_field:       { accessibility_id: 'Zip Code* input field' },
+             country_field:        { accessibility_id: 'Country* input field' }
+  checkbox   :bill_address_check,  { xpath: '//android.view.ViewGroup[contains(@content-desc, "checkbox")]/android.view.ViewGroup'}
+  button     :review_order_button, { accessibility_id: 'Review Order button' }
+end

data/features/support/android/screens/login_screen.rb

@@ -0,0 +1,18 @@
+class LoginScreen < BaseAppScreen
+  include SharedLoginScreen
+
+  trait(:page_name)    { 'Login' }
+  trait(:page_locator) { { accessibility_id: 'login screen' } }
+  trait(:page_url)     { 'login' }
+  trait(:navigator)    { nav_menu.open_log_in }
+
+  # Login screen UI elements
+  labels     username_label: { xpath: '//android.view.ViewGroup[@content-desc="login screen"]/android.widget.ScrollView/android.view.ViewGroup/android.widget.TextView[2]'},
+             password_label: { xpath: '//android.view.ViewGroup[@content-desc="login screen"]/android.widget.ScrollView/android.view.ViewGroup/android.widget.TextView[3]'},
+             username_error: { accessibility_id: 'Username-error-message' },
+             password_error: { accessibility_id: 'Password-error-message' },
+             generic_error:  { accessibility_id: 'generic-error-message' }
+  textfields username_field: { accessibility_id: 'Username input field' },
+             password_field: { accessibility_id: 'Password input field' }
+  button     :login_button,  { accessibility_id: 'Login button' }
+end

data/features/support/android/screens/products_screen.rb

@@ -0,0 +1,13 @@
+class ProductsScreen < BaseAppScreen
+  trait(:page_name)    { 'Products' }
+  trait(:page_locator) { { accessibility_id: 'products screen' } }
+  trait(:page_url)     { 'store-overview' }
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label => { visible: true, caption: 'Products' }
+    }
+    verify_ui_states(ui)
+  end
+end

data/features/support/android/screens/saucebot_screen.rb

@@ -0,0 +1,16 @@
+class SauceBotScreen < BaseAppScreen
+  include SharedSauceBotScreen
+
+  trait(:page_name)    { 'SauceBot Video' }
+  trait(:page_locator) { { accessibility_id: 'SauceBot screen' } }
+  trait(:navigator)    { nav_menu.open_saucebot_video }
+
+  # SauceBot Video screen UI elements
+  element :video_player, { xpath: '//android.view.View[@resource-id="movie_player"]' }
+  buttons video_back:    { accessibility_id: 'video icon backward' },
+          video_play:    { accessibility_id: 'video icon play' },
+          video_pause:   { accessibility_id: 'video icon stop' },
+          video_forward: { accessibility_id: 'video icon forward' },
+          video_volume:  { accessibility_id: 'video icon volume-up' },
+          video_mute:    { accessibility_id: 'video icon volume-mute' }
+end

data/features/support/android/screens/webview_screen.rb

@@ -0,0 +1,13 @@
+class WebViewScreen < BaseAppScreen
+  include SharedWebViewScreen
+
+  trait(:page_name)    { 'Webview' }
+  trait(:page_locator) { { accessibility_id: 'webview selection screen' } }
+  trait(:page_url)     { 'webview' }
+  trait(:navigator)    { nav_menu.open_webview }
+
+  # Webview screen UI elements
+  label     :url_label, { xpath: '//android.view.ViewGroup[@content-desc="webview selection screen"]/android.widget.ScrollView/android.view.ViewGroup/android.widget.TextView[1]' }
+  textfield :url_field, { accessibility_id: 'URL input field' }
+  button    :go_to_site_button, { accessibility_id: 'Go To Site button' }
+end

data/features/support/android/sections/nav_widgets/nav_menu.rb

@@ -0,0 +1,39 @@
+class NavMenu < TestCentricity::ScreenSection
+  include SharedNavMenu
+
+  trait(:section_name)    { 'Nav Menu' }
+  trait(:section_locator) { { xpath: '//android.widget.ScrollView/android.view.ViewGroup' } }
+
+  # Nav Menu UI elements
+  buttons close_button:        { accessibility_id: 'menu item catalog' },
+          webview_button:      { accessibility_id: 'menu item webview' },
+          qr_code_button:      { accessibility_id: 'menu item qr code scanner' },
+          geo_location_button: { accessibility_id: 'menu item geo location' },
+          drawing_button:      { accessibility_id: 'menu item drawing' },
+          about_button:        { accessibility_id: 'menu item about' },
+          reset_app_button:    { accessibility_id: 'menu item reset app' },
+          biometrics_button:   { accessibility_id: 'menu item biometrics' },
+          log_in_button:       { accessibility_id: 'menu item log in' },
+          log_out_button:      { accessibility_id: 'menu item log out' },
+          api_calls_button:    { accessibility_id: 'menu item api calls' },
+          sauce_video_button:  { accessibility_id: 'menu item sauce bot video' }
+
+  def verify_ui
+    ui = {
+      self                => { visible: true },
+      close_button        => { visible: true, enabled: true },
+      webview_button      => { visible: true, enabled: true, caption: 'Webview' },
+      qr_code_button      => { visible: true, enabled: true, caption: 'QR Code Scanner' },
+      geo_location_button => { visible: true, enabled: true, caption: 'Geo Location' },
+      drawing_button      => { visible: true, enabled: true, caption: 'Drawing' },
+      about_button        => { visible: true, enabled: true, caption: 'About' },
+      reset_app_button    => { visible: true, enabled: true, caption: 'Reset App State' },
+      biometrics_button   => { visible: true, enabled: true, caption: 'FingerPrint' },
+      log_in_button       => { visible: true, enabled: true, caption: 'Log In' },
+      log_out_button      => { visible: true, enabled: true, caption: 'Log Out' },
+      api_calls_button    => { visible: true, enabled: true, caption: 'Api Calls' },
+      sauce_video_button  => { visible: true, enabled: true, caption: 'Sauce Bot Video' }
+    }
+    verify_ui_states(ui)
+  end
+end