testcentricity 3.0.1 → 3.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31f94846b0235fd3b3507025052c4bc2672fc06d3646dd6e51f30a746522ceb8
-  data.tar.gz: 399961e0864716031576c8e12cd244b379ac2a67e2319d730c64cc1a431af49e
+  metadata.gz: e4c7b4120e8589701d29a850600108df295c1c199fa8c19e9f6f92bd76b49a47
+  data.tar.gz: 956e90ac6395ed32e69c2fd7558977398b8c42c075577d858090ce194da8c668
 SHA512:
-  metadata.gz: 76f54f2ca7d2338a17a112907b8d084c84e458f9f8b5f6e0bf82405734d252acd6042daaef739d76f60675f8167a25c297f8cf996413f099e9e528b194903d47
-  data.tar.gz: a5ac5ff41bfef9124b088492824c2583f5465fa855e42f6574a06498ac863503b9a280a88b58ff2bd3eb879fa75fb3176b914ad87da0a18586395c4f90309199
+  metadata.gz: b389a6ce9b701bb380ae02d34b7dc2880617aa315738a59082dfabf3c00fc2411d4f7ab99b3102f048918c9cc77e2e02b3b475fae3836986bfcc2237d7495112
+  data.tar.gz: b8d6b8ce2cb4cf7f98d66b8fe7ea7a9e4a1db0a07d3410660d5e6c06d962dc0bb48ce761d8998b4ac1475165ae042f8116109f049b8241e6eda7f64eb7147430

data/CHANGELOG.md

@@ -2,6 +2,29 @@
 All notable changes to this project will be documented in this file.
 
 
+## [3.0.4] - 02-JUNE-2022
+
+### Added
+* Added `AppUIElement.wait_until_enabled` method.
+
+### Updated
+* Incorporated all changes from the [TestCentricity™ Web gem](https://rubygems.org/gems/testcentricity_web) version 4.2.4, which is
+  bundled with this gem.
+
+
+## [3.0.3] - 30-MAY-2022
+
+### Added
+* Added `AppAlert.await_and_respond` method.
+
+
+## [3.0.2] - 26-MAY-2022
+
+### Fixed
+* Added runtime dependencies `curb` and `json` to gemspec.
+* Fixed CHANGELOG url in gemspec.
+
+
 ## [3.0.1] - 26-MAY-2022
 
 ### Added

data/README.md

@@ -536,6 +536,7 @@ With TestCentricity, all native app UI elements are based on the `AppUIElement`
     element.wait_until_gone(seconds)
     element.wait_until_visible(seconds)
     element.wait_until_hidden(seconds)
+    element.wait_until_enabled(seconds)
     element.wait_until_value_is(value, seconds)
     element.wait_until_value_changes(seconds)
 

data/Rakefile

@@ -35,7 +35,7 @@ desc 'Run required specs and Cucumber features'
 task required: [:required_specs, :android_sim, :ios_sim]
 
 
-desc 'Run all specs and Cucumber features'
+desc 'Run all specs'
 task all_specs: [:required_specs, :web_specs]
 
 
@@ -52,7 +52,7 @@ end
 desc 'Build and release new version'
 task :release do
   version = TestCentricity::VERSION
-  puts "Releasing #{version}, y/n?"
+  puts "Releasing version #{version} of TestCentricity gem, y/n?"
   exit(1) unless $stdin.gets.chomp == 'y'
   sh 'gem build testcentricity.gemspec && ' \
      "gem push testcentricity-#{version}.gem"

data/config/cucumber.yml

@@ -21,6 +21,7 @@ bvt:     <%= acceptance %>
 #==============
 
 report:   <%= reports %> REPORTING=true
+parallel: PARALLEL=true REPORTING=true --require features --format pretty --format html --out reports/test_results<%= ENV['TEST_ENV_NUMBER'] %>.html --format junit --out reports --format json --out reports/test_results<%= ENV['TEST_ENV_NUMBER'] %>.json
 
 
 #==============

data/config/test_data/data.yml

@@ -8,3 +8,69 @@ Environments:
     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'
 
+# This section is populated with user credential data required to test the Login screen features
+User_creds:
+  valid_data:
+    username: 'bob@example.com'
+    password: '10203040'
+  invalid_user:
+    username: 'iggy.snicklefritz@example.com'
+    password: '10203040'
+  locked_account:
+    username: 'alice@example.com'
+    password: '10203040'
+  no_username:
+    password: '10203040'
+  no_password:
+    username: 'bob@example.com'
+
+# This section is populated with Product data required for testing the Shopping features
+Products:
+  1:
+    id: 1
+    name: 'Sauce Labs Backpack'
+    description: 'carry.allTheThings() with the sleek, streamlined Sly Pack that melds uncompromising style with unequaled laptop and tablet protection.'
+    price: '$29.99'
+    review: 4
+    colors: ['BLACK', 'BLUE', 'GRAY', 'RED']
+    defaultColor: 'BLACK'
+  2:
+    id: 2
+    name: 'Sauce Labs Bike Light'
+    description: "A red light isn't the desired state in testing but it sure helps when riding your bike at night. Water-resistant with 3 lighting modes, 1 AAA battery included."
+    price: '$9.99'
+    review: 4
+    colors: ['BLACK']
+    defaultColor: 'BLACK'
+  3:
+    id: 3
+    name: 'Sauce Labs Bolt T-Shirt'
+    description: 'Get your testing superhero on with the Sauce Labs bolt T-shirt. From American Apparel, 100% ringspun combed cotton, heather gray with red bolt.'
+    price: '$15.99'
+    review: 4
+    colors: ['BLACK']
+    defaultColor: 'BLACK'
+  4:
+    id: 4
+    name: 'Sauce Labs Fleece Jacket'
+    description: "It's not every day that you come across a midweight quarter-zip fleece jacket capable of handling everything from a relaxing day outdoors to a busy day at the office."
+    price: '$49.99'
+    review: 4
+    colors: ['GRAY']
+    defaultColor: 'GRAY'
+  5:
+    id: 5
+    name: 'Sauce Labs Onesie'
+    description: "Rib snap infant onesie for the junior automation engineer in development. Reinforced 3-snap bottom closure, two-needle hemmed sleeved and bottom won't unravel."
+    price: '$7.99'
+    review: 4
+    colors: ['BLACK', 'GRAY', 'RED']
+    defaultColor: 'RED'
+  6:
+    id: 6
+    name: 'Test.allTheThings() T-Shirt'
+    description: 'This classic Sauce Labs t-shirt is perfect to wear when cozying up to your keyboard to automate a few tests. Super-soft and comfy ringspun combed cotton.'
+    price: '$15.99'
+    review: 4
+    colors: ['BLACK', 'GRAY', 'RED']
+    defaultColor: 'RED'

data/features/deep_links.feature

@@ -24,3 +24,15 @@ Feature:  App screen deep links
       |Products |Checkout - Address |
       |Products |Checkout - Payment |
       |About    |Products           |
+
+
+  Scenario Outline:  Verify Product Item screen can be directly accessed via deep links
+    Given I am on the Products screen
+    And I access the data for product id <product_id>
+    When I load the Product Item screen
+    Then I expect the Product Item screen to be correctly displayed
+
+    Examples:
+      |product_id |
+      |1          |
+      |5          |

data/features/navigation.feature

@@ -29,3 +29,15 @@ Feature:  Screen Navigation
       |Login          |
       |Webview        |
       |SauceBot Video |
+
+
+  Scenario Outline:  Verify screen navigation features with popup modals
+    When I tap the <screen_name> navigation menu item
+    And I accept the popup request modal
+    Then I expect the <screen_name> screen to be correctly displayed
+
+    Examples:
+      |screen_name     |
+      |QR Code Scanner |
+      |Geo Location    |
+      |Biometrics      |

data/features/step_definitions/generic_steps.rb

@@ -18,6 +18,7 @@ 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
+  PageManager.current_page = target_page
 end
 
 
@@ -30,25 +31,9 @@ Then(/^I expect the (.*) (?:page|screen) to be correctly displayed$/) do |screen
 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)
+When(/^I enter user credentials with (.*)$/) do |creds|
+  cred_data = user_data_source.find_user_creds(creds.gsub(/\s+/, '_').downcase)
+  login_screen.login(cred_data.username, cred_data.password)
 end
 
 
@@ -70,3 +55,13 @@ end
 Then(/^I expect the navigation menu to be hidden$/) do
   PageManager.current_page.verify_nav_menu(state = :closed)
 end
+
+
+When(/^I (.*) the popup request modal$/) do |action|
+  PageManager.current_page.modal_action(action)
+end
+
+
+When(/^I access the data for product id (.*)$/) do |product_id|
+  product_data_source.find_product(product_id)
+end

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

@@ -8,6 +8,8 @@ class BaseAppScreen < TestCentricity::ScreenObject
           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' }
+  alerts  grant_modal:   { id: 'com.android.permissioncontroller:id/grant_dialog' },
+          alert_modal:   { id: 'android:id/parentPanel' }
   section :nav_menu,     NavMenu
 
   def verify_page_ui

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

@@ -0,0 +1,17 @@
+class BiometricsScreen < BaseAppScreen
+  trait(:page_name)    { 'Biometrics' }
+  trait(:page_locator) { { accessibility_id: 'biometrics screen' } }
+  trait(:navigator)    { nav_menu.open_biometrics }
+
+  # Biometrics screen UI elements
+  switch :fingerprint_switch, { accessibility_id: 'biometrics switch'}
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label       => { visible: true, caption: 'FingerPrint' },
+      fingerprint_switch => { visible: true, enabled: false }
+    }
+    verify_ui_states(ui)
+  end
+end

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

@@ -0,0 +1,28 @@
+class GeoLocationScreen < BaseAppScreen
+  trait(:page_name)    { 'Geo Location' }
+  trait(:page_locator) { { accessibility_id: 'geo location screen' } }
+  trait(:page_url)     { 'geo-locations' }
+  trait(:navigator)    { nav_menu.open_geo_location }
+
+  # Geo Location screen UI elements
+  buttons start_observing_button: { accessibility_id: 'Start Observing button'},
+          stop_observing_button:  { accessibility_id: 'Stop Observing button'}
+  labels  latitude_data:          { accessibility_id: 'latitude data' },
+          longitude_data:         { accessibility_id: 'longitude data' }
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label           => { visible: true, caption: 'Geo Location' },
+      start_observing_button => { visible: true, enabled: false, caption: 'Start Observing' },
+      stop_observing_button  => { visible: true, enabled: true, caption: 'Stop Observing' },
+      latitude_data          => { visible: true, caption: { not_equal: '0' } },
+      longitude_data         => { visible: true, caption: { not_equal: '0' } }
+    }
+    verify_ui_states(ui)
+  end
+
+  def modal_action(action)
+    grant_modal.await_and_respond(action.downcase.to_sym, timeout = 1, button_name = 'Only this time')
+  end
+end

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

@@ -0,0 +1,39 @@
+class ProductItemScreen < BaseAppScreen
+  trait(:page_name)    { 'Product Item' }
+  trait(:page_locator) { { accessibility_id: 'product screen' } }
+  trait(:page_url)     { "product-details/#{ProductData.current.id.to_s}" }
+
+  # Product Item screen UI elements
+  labels  price_value:        { accessibility_id: 'product price' },
+          description_value:  { accessibility_id: 'product description' },
+          quantity_value:     { accessibility_id: 'counter amount' },
+          highlights_label:   { xpath: '//android.view.ViewGroup/android.widget.TextView[2]' }
+  image   :product_image,     { xpath: '//android.view.ViewGroup/android.widget.ImageView' }
+  buttons add_to_cart_button: { accessibility_id: 'Add To Cart button' },
+          minus_qty_button:   { accessibility_id: 'counter minus button' },
+          plus_qty_button:    { accessibility_id: 'counter plus button' },
+          black_color_button: { accessibility_id: 'black circle' },
+          blue_color_button:  { accessibility_id: 'blue circle' },
+          gray_color_button:  { accessibility_id: 'gray circle' },
+          red_color_button:   { accessibility_id: 'red circle' }
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label       => { visible: true, caption: ProductData.current.name },
+      price_value        => { visible: true, caption: ProductData.current.price },
+      highlights_label   => { visible: true, caption: 'Product Highlights' },
+      description_value  => { visible: true, caption: ProductData.current.description },
+      product_image      => { visible: true, enabled: true },
+      black_color_button => { visible: ProductData.current.colors.include?('BLACK') },
+      blue_color_button  => { visible: ProductData.current.colors.include?('BLUE') },
+      gray_color_button  => { visible: ProductData.current.colors.include?('GRAY') },
+      red_color_button   => { visible: ProductData.current.colors.include?('RED') },
+      minus_qty_button   => { visible: true, enabled: true },
+      quantity_value     => { visible: true, enabled: true, caption: '1' },
+      plus_qty_button    => { visible: true, enabled: true },
+      add_to_cart_button => { visible: true, enabled: true, caption: 'Add To Cart' }
+    }
+    verify_ui_states(ui)
+  end
+end

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

@@ -3,10 +3,24 @@ class ProductsScreen < BaseAppScreen
   trait(:page_locator) { { accessibility_id: 'products screen' } }
   trait(:page_url)     { 'store-overview' }
 
+  # Products screen UI elements
+  list    :product_list, { xpath: '//android.widget.ScrollView' }
+  section :product_list_item, ProductListItem
+
+  def initialize
+    super
+    # define the list item element for the Product list object
+    list_elements = { list_item: { xpath: '//android.view.ViewGroup[@content-desc="store item"]' } }
+    product_list.define_list_elements(list_elements)
+    # associate the Product List Item indexed section object with the Product list object
+    product_list_item.set_list_index(product_list)
+  end
+
   def verify_page_ui
     super
     ui = {
-      header_label => { visible: true, caption: 'Products' }
+      header_label => { visible: true, caption: 'Products' },
+      product_list => { visible: true, itemcount: 6 }
     }
     verify_ui_states(ui)
   end

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

@@ -0,0 +1,15 @@
+class QRCodeScannerScreen < BaseAppScreen
+  trait(:page_name)    { 'QR Code Scanner' }
+  trait(:page_locator) { { accessibility_id: 'qr code screen' } }
+  trait(:page_url)     { 'qr-code-scanner' }
+  trait(:navigator)    { nav_menu.open_qr_code_scanner }
+
+  def verify_page_ui
+    super
+    verify_ui_states(header_label => { visible: true, caption: 'QR Code Scanner' })
+  end
+
+  def modal_action(action)
+    grant_modal.await_and_respond(action.downcase.to_sym, timeout = 1, button_name = 'Only this time')
+  end
+end

data/features/support/android/sections/list_items/product_list_item.rb

@@ -0,0 +1,13 @@
+class ProductListItem < TestCentricity::ScreenSection
+  trait(:section_name)    { 'Product List Item' }
+  trait(:section_locator) { { xpath: '//android.view.ViewGroup[@content-desc="store item"]' } }
+
+  # Product Cell Item UI elements
+  labels  product_name:  { xpath: '//android.widget.TextView[@content-desc="store item text"]' },
+          product_price: { xpath: '//android.widget.TextView[@content-desc="store item price"]' }
+  buttons review_star_1: { xpath: '//android.view.ViewGroup[@content-desc="review star 1"]' },
+          review_star_2: { xpath: '//android.view.ViewGroup[@content-desc="review star 2"]' },
+          review_star_3: { xpath: '//android.view.ViewGroup[@content-desc="review star 3"]' },
+          review_star_4: { xpath: '//android.view.ViewGroup[@content-desc="review star 4"]' },
+          review_star_5: { xpath: '//android.view.ViewGroup[@content-desc="review star 5"]' }
+end

data/features/support/data/product_data.rb

@@ -0,0 +1,27 @@
+class ProductDataSource < TestCentricity::DataSource
+  def find_product(product_id)
+    ProductData.current = ProductData.new(environs.read('Products', product_id.to_i))
+  end
+end
+
+
+class ProductData < TestCentricity::DataPresenter
+  attribute :id, Integer
+  attribute :name, String
+  attribute :description, String
+  attribute :price, String
+  attribute :review, Integer
+  attribute :colors, Array
+  attribute :default_color, String
+
+  def initialize(data)
+    @id            = data[:id]
+    @name          = data[:name]
+    @description   = data[:description]
+    @price         = data[:price]
+    @review        = data[:review]
+    @colors        = data[:colors]
+    @default_color = data[:defaultColor]
+    super
+  end
+end

data/features/support/data/user_data.rb

@@ -0,0 +1,17 @@
+class UserDataSource < TestCentricity::DataSource
+  def find_user_creds(node_name)
+    UserData.current = UserData.new(environs.read('User_creds', node_name))
+  end
+end
+
+
+class UserData < TestCentricity::DataPresenter
+  attribute :username, String
+  attribute :password, String
+
+  def initialize(data)
+    @username = data[:username]
+    @password = data[:password]
+    super
+  end
+end

data/features/support/env.rb

@@ -4,8 +4,8 @@ require 'capybara/cucumber'
 require 'parallel_tests'
 require 'require_all'
 require 'simplecov'
-require 'testcentricity'
 require 'testcentricity_web'
+require 'testcentricity'
 
 include TestCentricity
 
@@ -14,6 +14,7 @@ SimpleCov.command_name("Features-#{ENV['PLATFORM']}-#{Time.now.strftime('%Y%m%d%
 require_relative 'world_data'
 require_relative 'world_pages'
 
+require_rel 'data'
 require_rel 'shared_components'
 
 # conditionally require page and section objects based on target platform

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

@@ -5,6 +5,7 @@ class BaseAppScreen < TestCentricity::ScreenObject
 
   # Base App screen UI elements
   label    :header_label, { accessibility_id: 'container header' }
+  alert    :alert_modal,  { class: 'XCUIElementTypeAlert' }
   sections nav_bar:  NavBar,
            nav_menu: NavMenu
 

data/features/support/ios/screens/biometrics_screen.rb

@@ -0,0 +1,17 @@
+class BiometricsScreen < BaseAppScreen
+  trait(:page_name)    { 'Biometrics' }
+  trait(:page_locator) { { accessibility_id: 'biometrics screen' } }
+  trait(:navigator)    { nav_menu.open_biometrics }
+
+  # Biometrics screen UI elements
+  switch :face_id_switch, { accessibility_id: 'biometrics switch'}
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label   => { visible: true, caption: 'FaceID' },
+      face_id_switch => { visible: true, enabled: false, value: '0' }
+    }
+    verify_ui_states(ui)
+  end
+end

data/features/support/ios/screens/geo_location_screen.rb

@@ -0,0 +1,32 @@
+class GeoLocationScreen < BaseAppScreen
+  trait(:page_name)    { 'Geo Location' }
+  trait(:page_locator) { { accessibility_id: 'geo location screen' } }
+  trait(:page_url)     { 'geo-locations' }
+  trait(:navigator)    { nav_menu.open_geo_location }
+
+  # Geo Location screen UI elements
+  buttons start_observing_button: { accessibility_id: 'Start Observing button'},
+          stop_observing_button:  { accessibility_id: 'Stop Observing button'}
+  labels  latitude_label:         { accessibility_id: 'Latitude:' },
+          latitude_data:          { accessibility_id: 'latitude data' },
+          longitude_label:        { accessibility_id: 'Longitude:' },
+          longitude_data:         { accessibility_id: 'longitude data' }
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label           => { visible: true, caption: 'Geo Location' },
+      start_observing_button => { visible: true, enabled: false, caption: 'Start Observing' },
+      stop_observing_button  => { visible: true, enabled: true, caption: 'Stop Observing' },
+      latitude_label         => { visible: true, caption: 'Latitude:' },
+      latitude_data          => { visible: true, caption: { not_equal: '0' } },
+      longitude_label        => { visible: true, caption: 'Longitude:' },
+      longitude_data         => { visible: true, caption: { not_equal: '0' } }
+    }
+    verify_ui_states(ui)
+  end
+
+  def modal_action(action)
+    alert_modal.await_and_respond(action.downcase.to_sym, timeout = 1, button_name = 'Allow Once')
+  end
+end

data/features/support/ios/screens/product_item_screen.rb

@@ -0,0 +1,39 @@
+class ProductItemScreen < BaseAppScreen
+  trait(:page_name)    { 'Product Item' }
+  trait(:page_locator) { { accessibility_id: 'product screen' } }
+  trait(:page_url)     { "product-details/#{ProductData.current.id.to_s}" }
+
+  # Product Item screen UI elements
+  labels  price_value:        { accessibility_id: 'product price' },
+          description_value:  { accessibility_id: 'product description' },
+          quantity_value:     { accessibility_id: 'counter amount' },
+          highlights_label:   { accessibility_id: 'Product Highlights' }
+  image   :product_image,     { xpath: '//XCUIElementTypeImage' }
+  buttons add_to_cart_button: { accessibility_id: 'Add To Cart button' },
+          minus_qty_button:   { accessibility_id: 'counter minus button' },
+          plus_qty_button:    { accessibility_id: 'counter plus button' },
+          black_color_button: { accessibility_id: 'black circle' },
+          blue_color_button:  { accessibility_id: 'blue circle' },
+          gray_color_button:  { accessibility_id: 'gray circle' },
+          red_color_button:   { accessibility_id: 'red circle' }
+
+  def verify_page_ui
+    super
+    ui = {
+      header_label       => { visible: true, caption: ProductData.current.name },
+      price_value        => { visible: true, caption: ProductData.current.price },
+      highlights_label   => { visible: true, caption: 'Product Highlights' },
+      description_value  => { visible: true, caption: ProductData.current.description },
+      product_image      => { visible: true, enabled: true },
+      black_color_button => { visible: ProductData.current.colors.include?('BLACK') },
+      blue_color_button  => { visible: ProductData.current.colors.include?('BLUE') },
+      gray_color_button  => { visible: ProductData.current.colors.include?('GRAY') },
+      red_color_button   => { visible: ProductData.current.colors.include?('RED') },
+      minus_qty_button   => { visible: true, enabled: true },
+      quantity_value     => { visible: true, enabled: true, caption: '1' },
+      plus_qty_button    => { visible: true, enabled: true },
+      add_to_cart_button => { visible: true, enabled: true, caption: 'Add To Cart' }
+    }
+    verify_ui_states(ui)
+  end
+end

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

@@ -3,10 +3,24 @@ class ProductsScreen < BaseAppScreen
   trait(:page_locator) { { accessibility_id: 'products screen' } }
   trait(:page_url)     { 'store-overview' }
 
+  # Products screen UI elements
+  list    :product_list, { xpath: '//XCUIElementTypeScrollView/XCUIElementTypeOther[1]' }
+  section :product_list_item, ProductListItem
+
+  def initialize
+    super
+    # define the list item element for the Product list object
+    list_elements = { list_item: { xpath: '//XCUIElementTypeOther[@name="store item"]' } }
+    product_list.define_list_elements(list_elements)
+    # associate the Product List Item indexed section object with the Product list object
+    product_list_item.set_list_index(product_list)
+  end
+
   def verify_page_ui
     super
     ui = {
-      header_label => { visible: true, caption: 'Products' }
+      header_label => { visible: true, caption: 'Products' },
+      # product_list => { visible: true, itemcount: 6 }
     }
     verify_ui_states(ui)
   end

data/features/support/ios/screens/qr_code_scanner_screen.rb

@@ -0,0 +1,11 @@
+class QRCodeScannerScreen < BaseAppScreen
+  trait(:page_name)    { 'QR Code Scanner' }
+  trait(:page_locator) { { accessibility_id: 'qr code screen' } }
+  trait(:page_url)     { 'qr-code-scanner' }
+  trait(:navigator)    { nav_menu.open_qr_code_scanner }
+
+  def verify_page_ui
+    super
+    verify_ui_states(header_label => { visible: true, caption: 'QR Code Scanner' })
+  end
+end

data/features/support/ios/sections/list_items/product_list_item.rb

@@ -0,0 +1,13 @@
+class ProductListItem < TestCentricity::ScreenSection
+  trait(:section_name)    { 'Product List Item' }
+  trait(:section_locator) { { xpath: '//XCUIElementTypeOther[@name="store item"]' } }
+
+  # Product Cell Item UI elements
+  labels  product_name:  { xpath: '//XCUIElementTypeStaticText[@name="store item text"]' },
+          product_price: { xpath: '//XCUIElementTypeStaticText[@name="store item price"]' }
+  buttons review_star_1: { xpath: '//XCUIElementTypeOther[@name="review star 1"]' },
+          review_star_2: { xpath: '//XCUIElementTypeOther[@name="review star 2"]' },
+          review_star_3: { xpath: '//XCUIElementTypeOther[@name="review star 3"]' },
+          review_star_4: { xpath: '//XCUIElementTypeOther[@name="review star 4"]' },
+          review_star_5: { xpath: '//XCUIElementTypeOther[@name="review star 5"]' }
+end

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

@@ -28,4 +28,8 @@ module SharedBaseAppScreen
       raise "#{action} is not a valid selector"
     end
   end
+
+  def modal_action(action)
+    alert_modal.await_and_respond(action.downcase.to_sym, timeout = 1)
+  end
 end

data/features/support/world_data.rb

@@ -4,7 +4,10 @@ module WorldData
   #  by the TestCentricity™ DataManager. Data Object class definitions are contained in the features/support/data folder.
   #
   def data_objects
-    {}
+    {
+      user_data_source:    UserDataSource,
+      product_data_source: ProductDataSource
+    }
   end
 end
 

data/features/support/world_pages.rb

@@ -15,8 +15,12 @@ module WorldPages
       login_screen:            LoginScreen,
       webview_screen:          WebViewScreen,
       products_screen:         ProductsScreen,
+      product_item_screen:     ProductItemScreen,
       checkout_address_screen: CheckoutAddressScreen,
       checkout_payment_screen: CheckoutPaymentScreen,
+      qr_code_scanner_screen:  QRCodeScannerScreen,
+      geo_location_screen:     GeoLocationScreen,
+      biometrics_screen:       BiometricsScreen,
       saucebot_video_screen:   SauceBotScreen
     }
   end

data/lib/testcentricity/app_elements/alert.rb

@@ -5,6 +5,16 @@ module TestCentricity
       @type = :alert
     end
 
+    # Wait until the alert modal is visible, or until the specified wait time has expired. If the wait time is nil, then the
+    # wait time will be Environ.default_max_wait_time. Unlike wait_until_visible or wait_until_exists, this method does not
+    # raise an exception if the alert modal does not appear within the specified wait time.
+    # Returns true if the alert modal is visible.
+    #
+    # @return [Integer]
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   permissions_modal.await(2)
+    #
     def await(seconds)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
@@ -14,14 +24,68 @@ module TestCentricity
       false
     end
 
+    # Performs the action required accept the currently visible alert modal. If the alert modal is still visible after
+    # 5 seconds, an exception is raised.
+    #
+    # @example
+    #   alert_modal.accept
+    #
     def accept
       alert_accept
       wait_until_gone(5)
     end
 
+    # Performs the action required dismiss the currently visible alert modal. If the alert modal is still visible after
+    # 5 seconds, an exception is raised.
+    #
+    # @example
+    #   alert_modal.dismiss
+    #
     def dismiss
       alert_dismiss
       wait_until_gone(5)
     end
+
+    #
+    # @return [Integer]
+    # @param action [Symbol] action to perform if alert modal is visible. Acceptable values are :allow, :accept, :dont_allow, or :dismiss
+    # @param timeout [Integer or Float] wait time in seconds. Defaults to 2 if not specified
+    # @param button_name [String] optional caption of button to tap associated with the specified action
+    # @example
+    #   alert_modal.await_and_respond(:dismiss)
+    #        OR
+    #   permissions_modal.await_and_respond(:accept, timeout = 1, button_name = 'Allow Once')
+    #
+    def await_and_respond(action, timeout = 2, button_name = nil)
+      if await(timeout)
+        case action
+        when :allow, :accept
+          if button_name.nil?
+            accept
+          elsif Environ.is_ios?
+            $driver.execute_script('mobile: alert', { action: 'accept', buttonLabel: button_name })
+          else
+            $driver.execute_script('mobile: acceptAlert', { buttonLabel: button_name })
+          end
+        when :dont_allow, :dismiss
+          if button_name.nil?
+            dismiss
+          elsif Environ.is_ios?
+            $driver.execute_script('mobile: alert', { action: 'dismiss', buttonLabel: button_name })
+          else
+            $driver.execute_script('mobile: dismissAlert', { buttonLabel: button_name })
+          end
+        else
+          raise "#{action} is not a valid selector"
+        end
+        if Environ.is_ios? && await(1)
+          buttons = $driver.execute_script('mobile: alert', { action: 'getButtons' })
+          raise "Could not perform #{action} action on active modal. Available modal buttons are #{buttons}"
+        end
+        true
+      else
+        false
+      end
+    end
   end
 end

data/lib/testcentricity/app_elements/app_element_helper.rb

@@ -174,12 +174,16 @@ module TestCentricity
     # @example
     #   run_button.wait_until_exists(0.5)
     #
-    def wait_until_exists(seconds = nil)
+    def wait_until_exists(seconds = nil, post_exception = true)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { exists? }
     rescue
-      raise "Could not find UI #{object_ref_message} after #{timeout} seconds" unless exists?
+      if post_exception
+        raise "Could not find UI #{object_ref_message} after #{timeout} seconds" unless exists?
+      else
+        exists?
+      end
     end
 
     # Wait until the object no longer exists, or until the specified wait time has expired. If the wait time is nil, then
@@ -189,12 +193,16 @@ module TestCentricity
     # @example
     #   logout_button.wait_until_gone(5)
     #
-    def wait_until_gone(seconds = nil)
+    def wait_until_gone(seconds = nil, post_exception = true)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { !exists? }
     rescue
-      raise "UI #{object_ref_message} remained visible after #{timeout} seconds" if exists?
+      if post_exception
+        raise "UI #{object_ref_message} remained visible after #{timeout} seconds" if exists?
+      else
+        exists?
+      end
     end
 
     # Wait until the object is visible, or until the specified wait time has expired. If the wait time is nil, then the
@@ -204,12 +212,16 @@ module TestCentricity
     # @example
     #   run_button.wait_until_visible(0.5)
     #
-    def wait_until_visible(seconds = nil)
+    def wait_until_visible(seconds = nil, post_exception = true)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { visible? }
     rescue
-      raise "Could not find UI #{object_ref_message} after #{timeout} seconds" unless visible?
+      if post_exception
+        raise "Could not find UI #{object_ref_message} after #{timeout} seconds" unless visible?
+      else
+        visible?
+      end
     end
 
     # Wait until the object is hidden, or until the specified wait time has expired. If the wait time is nil, then the
@@ -219,12 +231,35 @@ module TestCentricity
     # @example
     #   run_button.wait_until_hidden(10)
     #
-    def wait_until_hidden(seconds = nil)
+    def wait_until_hidden(seconds = nil, post_exception = true)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { hidden? }
     rescue
-      raise "UI #{object_ref_message} remained visible after #{timeout} seconds" if visible?
+      if post_exception
+        raise "UI #{object_ref_message} remained visible after #{timeout} seconds" if visible?
+      else
+        hidden?
+      end
+    end
+
+    # Wait until the object is enabled, or until the specified wait time has expired. If the wait time is nil, then the
+    # wait time will be Environ.default_max_wait_time.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   run_button.wait_until_enabled(10)
+    #
+    def wait_until_enabled(seconds = nil, post_exception = true)
+      timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { enabled? }
+    rescue
+      if post_exception
+        raise "UI #{object_ref_message} remained disabled after #{timeout} seconds" unless enabled?
+      else
+        enabled?
+      end
     end
 
     # Wait until the object's value equals the specified value, or until the specified wait time has expired. If the wait
@@ -237,12 +272,16 @@ module TestCentricity
     #     or
     #   total_weight_field.wait_until_value_is({ :greater_than => '250' }, 5)
     #
-    def wait_until_value_is(value, seconds = nil)
+    def wait_until_value_is(value, seconds = nil, post_exception = true)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { compare(value, get_value) }
     rescue
-      raise "Value of UI #{object_ref_message} failed to equal '#{value}' after #{timeout} seconds" unless get_value == value
+      if post_exception
+        raise "Value of UI #{object_ref_message} failed to equal '#{value}' after #{timeout} seconds" unless get_value == value
+      else
+        get_value == value
+      end
     end
 
     # Wait until the object's value changes to a different value, or until the specified wait time has expired. If the
@@ -252,13 +291,17 @@ module TestCentricity
     # @example
     #   basket_grand_total_label.wait_until_value_changes(5)
     #
-    def wait_until_value_changes(seconds = nil)
+    def wait_until_value_changes(seconds = nil, post_exception = true)
       value = get_value
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { get_value != value }
     rescue
-      raise "Value of UI #{object_ref_message} failed to change from '#{value}' after #{timeout} seconds" if get_value == value
+      if post_exception
+        raise "Value of UI #{object_ref_message} failed to change from '#{value}' after #{timeout} seconds" if get_value == value
+      else
+        get_value == value
+      end
     end
 
     def width

data/lib/testcentricity/version.rb

@@ -1,3 +1,3 @@
 module TestCentricity
-  VERSION = '3.0.1'
+  VERSION = '3.0.4'
 end

data/testcentricity.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.7.5'
   spec.authors       = ['A.J. Mrozinski']
   spec.email         = ['testcentricity@gmail.com']
-  spec.summary       = %q{A Page Object Model Framework for desktop/mobile web and native mobile app testing}
+  spec.summary       = %q{A Page Object Model Framework for native mobile app and desktop/mobile web portal testing}
   spec.description   = '
     The TestCentricity™ core framework for native mobile iOS and Android apps and desktop/mobile web testing implements a Page Object
     Model DSL for use with Cucumber, Appium, Capybara, and Selenium-Webdriver v4.x. The gem also facilitates the configuration of the
@@ -33,8 +33,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'cucumber'
   spec.add_development_dependency 'cuke_modeler', '~> 3.0'
-  spec.add_development_dependency 'curb'
-  spec.add_development_dependency 'json'
   spec.add_development_dependency 'parallel_tests'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'require_all', '=1.5.0'
@@ -43,6 +41,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'yard', ['>= 0.9.0']
 
   spec.add_runtime_dependency 'appium_lib'
-  spec.add_runtime_dependency 'testcentricity_web', '>= 4.2.2'
+  spec.add_runtime_dependency 'curb'
+  spec.add_runtime_dependency 'json'
+  spec.add_runtime_dependency 'testcentricity_web', '>= 4.2.4'
   spec.add_runtime_dependency 'test-unit'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.0.4
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-26 00:00:00.000000000 Z
+date: 2022-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,34 +52,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: curb
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: parallel_tests
   requirement: !ruby/object:Gem::Requirement
@@ -178,20 +150,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: curb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: testcentricity_web
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.2.2
+        version: 4.2.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.2.2
+        version: 4.2.4
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -233,7 +233,6 @@ files:
 - Rakefile
 - config/cucumber.yml
 - config/locales/en-US.yml
-- config/test_data/LOCAL_data.yml
 - config/test_data/data.yml
 - features/deep_links.feature
 - features/login.feature
@@ -241,27 +240,35 @@ files:
 - features/step_definitions/generic_steps.rb
 - features/support/android/screens/about_screen.rb
 - features/support/android/screens/base_app_screen.rb
+- features/support/android/screens/biometrics_screen.rb
 - features/support/android/screens/checkout_address_screen.rb
 - features/support/android/screens/checkout_payment_screen.rb
+- features/support/android/screens/geo_location_screen.rb
 - features/support/android/screens/login_screen.rb
+- features/support/android/screens/product_item_screen.rb
 - features/support/android/screens/products_screen.rb
+- features/support/android/screens/qr_code_scanner_screen.rb
 - features/support/android/screens/saucebot_screen.rb
 - features/support/android/screens/webview_screen.rb
+- features/support/android/sections/list_items/product_list_item.rb
 - features/support/android/sections/nav_widgets/nav_menu.rb
+- features/support/data/product_data.rb
+- features/support/data/user_data.rb
 - features/support/env.rb
 - features/support/hooks.rb
 - features/support/ios/screens/about_screen.rb
 - features/support/ios/screens/base_app_screen.rb
+- features/support/ios/screens/biometrics_screen.rb
 - features/support/ios/screens/checkout_address_screen.rb
 - features/support/ios/screens/checkout_payment_screen.rb
+- features/support/ios/screens/geo_location_screen.rb
 - features/support/ios/screens/login_screen.rb
+- features/support/ios/screens/product_item_screen.rb
 - features/support/ios/screens/products_screen.rb
+- features/support/ios/screens/qr_code_scanner_screen.rb
 - features/support/ios/screens/saucebot_screen.rb
 - features/support/ios/screens/webview_screen.rb
-- features/support/ios/sections/list_items/product_cell_item.rb
-- features/support/ios/sections/modals/base_modal.rb
-- features/support/ios/sections/modals/logout_modal.rb
-- features/support/ios/sections/modals/reset_app_state_modal.rb
+- features/support/ios/sections/list_items/product_list_item.rb
 - features/support/ios/sections/nav_widgets/nav_bar.rb
 - features/support/ios/sections/nav_widgets/nav_menu.rb
 - features/support/shared_components/screens/base_app_screen.rb
@@ -337,8 +344,8 @@ requirements:
 rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
-summary: A Page Object Model Framework for desktop/mobile web and native mobile app
-  testing
+summary: A Page Object Model Framework for native mobile app and desktop/mobile web
+  portal testing
 test_files:
 - features/deep_links.feature
 - features/login.feature
@@ -346,27 +353,35 @@ test_files:
 - features/step_definitions/generic_steps.rb
 - features/support/android/screens/about_screen.rb
 - features/support/android/screens/base_app_screen.rb
+- features/support/android/screens/biometrics_screen.rb
 - features/support/android/screens/checkout_address_screen.rb
 - features/support/android/screens/checkout_payment_screen.rb
+- features/support/android/screens/geo_location_screen.rb
 - features/support/android/screens/login_screen.rb
+- features/support/android/screens/product_item_screen.rb
 - features/support/android/screens/products_screen.rb
+- features/support/android/screens/qr_code_scanner_screen.rb
 - features/support/android/screens/saucebot_screen.rb
 - features/support/android/screens/webview_screen.rb
+- features/support/android/sections/list_items/product_list_item.rb
 - features/support/android/sections/nav_widgets/nav_menu.rb
+- features/support/data/product_data.rb
+- features/support/data/user_data.rb
 - features/support/env.rb
 - features/support/hooks.rb
 - features/support/ios/screens/about_screen.rb
 - features/support/ios/screens/base_app_screen.rb
+- features/support/ios/screens/biometrics_screen.rb
 - features/support/ios/screens/checkout_address_screen.rb
 - features/support/ios/screens/checkout_payment_screen.rb
+- features/support/ios/screens/geo_location_screen.rb
 - features/support/ios/screens/login_screen.rb
+- features/support/ios/screens/product_item_screen.rb
 - features/support/ios/screens/products_screen.rb
+- features/support/ios/screens/qr_code_scanner_screen.rb
 - features/support/ios/screens/saucebot_screen.rb
 - features/support/ios/screens/webview_screen.rb
-- features/support/ios/sections/list_items/product_cell_item.rb
-- features/support/ios/sections/modals/base_modal.rb
-- features/support/ios/sections/modals/logout_modal.rb
-- features/support/ios/sections/modals/reset_app_state_modal.rb
+- features/support/ios/sections/list_items/product_list_item.rb
 - features/support/ios/sections/nav_widgets/nav_bar.rb
 - features/support/ios/sections/nav_widgets/nav_menu.rb
 - features/support/shared_components/screens/base_app_screen.rb

data/config/test_data/LOCAL_data.yml

@@ -1,11 +0,0 @@
-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/features/support/ios/sections/list_items/product_cell_item.rb

@@ -1,13 +0,0 @@
-class ProductCellItem < TestCentricity::ScreenSection
-  trait(:section_name)    { 'Product Cell Item' }
-  trait(:section_locator) { { xpath: "//XCUIElementTypeOther[@name='store item']" } }
-
-  # Product Cell Item UI elements
-  labels  product_name:  { xpath: '(//XCUIElementTypeOther)[1]' },
-          product_price: { xpath: "//XCUIElementTypeStaticText[@name='store item price']" }
-  buttons review_star_1: { xpath: "//XCUIElementTypeOther[@name='review star 1']" },
-          review_star_2: { xpath: "//XCUIElementTypeOther[@name='review star 2']" },
-          review_star_3: { xpath: "//XCUIElementTypeOther[@name='review star 3']" },
-          review_star_4: { xpath: "//XCUIElementTypeOther[@name='review star 4']" },
-          review_star_5: { xpath: "//XCUIElementTypeOther[@name='review star 5']" }
-end

data/features/support/ios/sections/modals/base_modal.rb

@@ -1,23 +0,0 @@
-class BaseIOSModal < TestCentricity::ScreenSection
-  trait(:section_name)    { 'Base iOS Modal' }
-  trait(:section_locator) { { class: 'XCUIElementTypeAlert' } }
-
-  # Base Modal UI elements
-  alert :alert_modal, { class: 'XCUIElementTypeAlert' }
-
-  def await_and_respond(action, timeout)
-    if alert_modal.await(timeout)
-      case action
-      when :allow, :accept
-        alert_modal.accept
-      when :dont_allow, :dismiss
-        alert_modal.dismiss
-      else
-        raise "#{action} is not a valid selector"
-      end
-      true
-    else
-      false
-    end
-  end
-end

data/features/support/ios/sections/modals/logout_modal.rb

@@ -1,6 +0,0 @@
-class LogOutModal < BaseIOSModal
-  trait(:section_name) { 'Log Out Modal' }
-
-  # Log Out Modal UI elements
-  alert :alert_modal, { xpath: "//XCUIElementTypeAlert[@name='Log Out']" }
-end

data/features/support/ios/sections/modals/reset_app_state_modal.rb

@@ -1,6 +0,0 @@
-class ResetAppStateModal < BaseIOSModal
-  trait(:section_name) { 'Reset App State Modal' }
-
-  # Reset App State Modal UI elements
-  alert :alert_modal, { xpath: "//XCUIElementTypeAlert[@name='Reset App State']" }
-end