testcentricity_web 4.1.4 → 4.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee1ff6311bce503168094dbc5546d00419187e6991d67073d590d0cf2dd6beac
-  data.tar.gz: 5a776195eb96437187dae63eb12f9e6c1cfe0580811dbc369dc09ac75d76e300
+  metadata.gz: 58ddfdbcb8747347fcb06efdd2a888509fa904bd5541a0f3d4d303af6469552c
+  data.tar.gz: 14f9af8661d7e571d10f79e3d093cafa4e744388d5c1d6f9232e207fe5e82d6f
 SHA512:
-  metadata.gz: 5c05c61753313054175c4d3ae0a36dabe8fd089a2178918e6d796a26806be5af5d6a5020a55658b1951b4d62adfb63725c610afa4c0b4b4612e6e675de015b62
-  data.tar.gz: 279053b4a2323f9089c183bebf286afb6dbb9be22f9bfee0b22264d2810d1ce77e17b33cec22e26d9b1fd6bdd970c41e2cd1cd1c36a11f010fa0d125fd95e80f
+  metadata.gz: 768e113468d0dfc68f01467bc4304f41903bff09f59db9f2c8dd013545c061523c7e0947669d1befadcf43b1187e57df3cb188d803b3d802d905c0c3467ce852
+  data.tar.gz: 3133dc1f23ff3a839c45e2c6424d152f6c85916497c00dd9a815113f2acb8225f45efab91ce9d7cb4ada454d33115649ad61f4073f109a7dec44e40891971043

data/.gitignore

@@ -18,3 +18,21 @@ Thumbs.db
 
 # rspec failure tracking
 .rspec_status
+
+# Ignore test-reports
+reports/*.html
+reports/*.xml
+reports/*.json
+reports/screenshots/
+test-reports
+capybara-*.html
+debug.log
+
+BrowserStackLocal
+cbttunnel.jar
+
+/.yardoc/
+/local.log
+.run/*.xml
+
+echo coverage >> .gitignore

data/.simplecov

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'simplecov'
+
+SimpleCov.start

data/CHANGELOG.md

@@ -2,6 +2,48 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.1.7] - 28-MAR-2022
+
+### Fixed
+* `CheckBox.set_checkbox_state` and `Radio.set_selected_state` work on iOS simulators again.
+
+### Changes
+* `Audio.playback_rate` and `Video.playback_rate` now return value as a `Float` instead of a `String`.
+* `Audio.default_playback_rate` and `Video.default_playback_rate` now return value as a `Float` instead of a `String`.
+* `Audio.current_time` and `Video.current_time` now return value as a `Float` rounded to two decimal places.
+* `Audio.duration` and `Video.duration` now return value as a `Float` rounded to two decimal places.
+
+### Added
+* `Audio.mute` and `Video.mute` methods added.
+* `Audio.unmute` and `Video.unmute` methods added.
+* `Audio.playback_rate` and `Video.playback_rate` now accept a `Float` value as an input for setting the playback rate
+  of media.
+* `Audio.volume` and `Video.volume` now accept a `Float` value between 0 and 1 as an input for setting the volume of media.
+
+
+## [4.1.6] - 21-MAR-2022
+
+### Fixed
+* `PageObject.verify_page_exists` now works with `page_locator` traits expressed in Xpath format, and no longer fails with a
+`invalid selector: An invalid or illegal selector was specified - Selenium::WebDriver::Error::InvalidSelectorError` error.
+
+### Added
+* `UIElement.required?` method added.
+* `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods now work with the following:
+  * `input(type='color')` color picker controls if they are specified as a `textfield` type element.
+  * `input(type='range')` slider controls if they are specified as a `range` type element.
+  * `input(type='file')` file upload controls if they are specified as a `filefield` type element.
+
+
+## [4.1.5] - 15-MAR-2022
+
+### Fixed
+* `SelectList.selected?` now correctly returns selected value for custom `selectlist` controls.
+
+### Updated
+* Updated HTML documentation.
+
+
 ## [4.1.4] - 09-MAR-2022
 
 ### Fixed
@@ -19,7 +61,7 @@ All notable changes to this project will be documented in this file.
 
 ## [4.1.2] - 07-MAR-2022
 
-### Changed
+### Updated
 * Updated HTML documentation.
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (4.1.4)
+    testcentricity_web (4.1.7)
       appium_lib
       browserstack-local
       capybara (>= 3.1, < 4)
@@ -21,6 +21,9 @@ GEM
   specs:
     addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
+    appium_capybara (2.0.0)
+      appium_lib (~> 12.0.0)
+      capybara (~> 3.36)
     appium_lib (12.0.0)
       appium_lib_core (~> 5.0.0)
       nokogiri (~> 1.8, >= 1.8.1)
@@ -33,6 +36,7 @@ GEM
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
     browserstack-local (1.3.0)
+    builder (3.2.4)
     capybara (3.36.0)
       addressable
       matrix
@@ -46,23 +50,63 @@ GEM
     chronic (0.10.2)
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
-    concurrent-ruby (1.1.9)
+    concurrent-ruby (1.1.10)
+    cucumber (7.1.0)
+      builder (~> 3.2, >= 3.2.4)
+      cucumber-core (~> 10.1, >= 10.1.0)
+      cucumber-create-meta (~> 6.0, >= 6.0.1)
+      cucumber-cucumber-expressions (~> 14.0, >= 14.0.0)
+      cucumber-gherkin (~> 22.0, >= 22.0.0)
+      cucumber-html-formatter (~> 17.0, >= 17.0.0)
+      cucumber-messages (~> 17.1, >= 17.1.1)
+      cucumber-wire (~> 6.2, >= 6.2.0)
+      diff-lcs (~> 1.4, >= 1.4.4)
+      mime-types (~> 3.3, >= 3.3.1)
+      multi_test (~> 0.1, >= 0.1.2)
+      sys-uname (~> 1.2, >= 1.2.2)
+    cucumber-core (10.1.1)
+      cucumber-gherkin (~> 22.0, >= 22.0.0)
+      cucumber-messages (~> 17.1, >= 17.1.1)
+      cucumber-tag-expressions (~> 4.1, >= 4.1.0)
+    cucumber-create-meta (6.0.4)
+      cucumber-messages (~> 17.1, >= 17.1.1)
+      sys-uname (~> 1.2, >= 1.2.2)
+    cucumber-cucumber-expressions (14.0.0)
+    cucumber-gherkin (22.0.0)
+      cucumber-messages (~> 17.1, >= 17.1.1)
+    cucumber-html-formatter (17.0.0)
+      cucumber-messages (~> 17.1, >= 17.1.0)
+    cucumber-messages (17.1.1)
+    cucumber-tag-expressions (4.1.0)
+    cucumber-wire (6.2.1)
+      cucumber-core (~> 10.1, >= 10.1.0)
+      cucumber-cucumber-expressions (~> 14.0, >= 14.0.0)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.5.0)
+    docile (1.4.0)
     eventmachine (1.2.7)
     faker (2.20.0)
       i18n (>= 1.8.11, < 2)
     faye-websocket (0.11.1)
       eventmachine (>= 0.12.0)
       websocket-driver (>= 0.5.1)
+    ffi (1.15.5)
     i18n (1.10.0)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
     matrix (0.4.2)
+    mime-types (3.4.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2022.0105)
     mini_mime (1.1.2)
+    multi_test (0.1.2)
     nokogiri (1.13.3-x86_64-darwin)
       racc (~> 1.4)
     os (1.1.4)
+    parallel (1.21.0)
+    parallel_tests (3.7.3)
+      parallel
     power_assert (2.0.1)
     public_suffix (4.0.6)
     racc (1.6.0)
@@ -72,6 +116,7 @@ GEM
     rake (13.0.6)
     redcarpet (3.5.1)
     regexp_parser (2.2.1)
+    require_all (1.5.0)
     rexml (3.2.5)
     ruby-ole (1.2.12.2)
     rubyzip (2.3.2)
@@ -79,8 +124,16 @@ GEM
       childprocess (>= 0.5, < 5.0)
       rexml (~> 3.2, >= 3.2.5)
       rubyzip (>= 1.2.2)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
     spreadsheet (1.1.7)
       ruby-ole (>= 1.0)
+    sys-uname (1.2.2)
+      ffi (~> 1.1)
     test-unit (3.5.3)
       power_assert
     thread_safe (0.3.6)
@@ -103,9 +156,14 @@ PLATFORMS
   x86_64-darwin-21
 
 DEPENDENCIES
+  appium_capybara
   bundler
+  cucumber
+  parallel_tests
   rake
   redcarpet
+  require_all
+  simplecov (~> 0.18)
   testcentricity_web!
 
 BUNDLED WITH

data/README.md

@@ -3,9 +3,9 @@
 [![Gem Version](https://badge.fury.io/rb/testcentricity_web.svg)](https://badge.fury.io/rb/testcentricity_web)  [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
 
 
-The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements a Page Object and Data
-Object Model DSL for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.x). It also facilitates the configuration
-of the appropriate Selenium-Webdriver capabilities required to establish a connection with a local or cloud hosted desktop or mobile web browser.
+The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements a Page Object Model DSL
+for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.x). It also facilitates the configuration of the appropriate
+Selenium-Webdriver capabilities required to establish a connection with a local or cloud hosted desktop or mobile web browser.
 
 The TestCentricity™ Web gem supports running automated tests against the following web test targets:
 * locally hosted desktop browsers (Chrome, Edge, Firefox, Safari, or IE)
@@ -49,7 +49,7 @@ Or install it yourself as:
 ## Setup
 ### Using Cucumber
 
-If you are using Cucumber, you need to require the following in your *env.rb* file:
+If you are using Cucumber, you need to require the following in your `env.rb` file:
 
     require 'capybara/cucumber'
     require 'testcentricity_web'
@@ -57,7 +57,7 @@ If you are using Cucumber, you need to require the following in your *env.rb* fi
 
 ### Using RSpec
 
-If you are using RSpec instead, you need to require the following in your *env.rb* file:
+If you are using RSpec instead, you need to require the following in your `env.rb` file:
 
     require 'capybara'
     require 'capybara/rspec'
@@ -67,7 +67,7 @@ If you are using RSpec instead, you need to require the following in your *env.r
 ### Using Appium
 
 If you will be running your tests on mobile Safari browsers on simulated iOS devices using Appium and XCode Simulators, you need to require
-the following in your *env.rb* file:
+the following in your `env.rb` file:
 
     require 'appium_capybara'
 
@@ -239,7 +239,7 @@ the UI to hide implementation details, as shown below:
             remember_checkbox    => { exists: true, enabled: true, checked: false },
             forgot_password_link => { visible: true, caption: 'Forgot your password?' },
             error_message_label  => { visible: false }
-            }
+        }
         verify_ui_states(ui)
       end
     end
@@ -282,7 +282,7 @@ the UI to hide implementation details, as shown below:
                    password_field      => profile.password,
                    pword_confirm_field => profile.confirm_password,
                    email_opt_in_check  => profile.email_opt_in
-          }
+        }
         populate_data_fields(fields)
         sign_up_button.click
       end
@@ -503,6 +503,7 @@ With TestCentricity, all UI elements are based on the `UIElement` class, and inh
     element.displayed?
     element.obscured?
     element.focused?
+    element.required?
     element.content_editable?
     element.get_value
     element.count
@@ -569,9 +570,10 @@ interacted with.
 
 The `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods support the entry of test data into a collection of
 `UIElements`. The `populate_data_fields` method accepts a hash containing key/hash pairs of `UIElements` and their associated data to be
-entered. Data values must be in the form of a `String` for `textfield` and `selectlist` controls. For `checkbox` and `radio` controls, data
-must either be a `Boolean` or a `String` that evaluates to a `Boolean` value (Yes, No, 1, 0, true, false). For `section` objects, data values
-must be a `String`, and the `section` object must have a `set` method defined.
+entered. Data values must be in the form of a `String` for `textfield`, `selectlist`, and `filefield` controls. For `checkbox` and `radio`
+controls, data must either be a `Boolean` or a `String` that evaluates to a `Boolean` value (Yes, No, 1, 0, true, false). For `range` controls,
+data must be an `Integer`. For `input(type='color')` color picker controls, which are specified as a `textfield`, data must be in the form
+of a hex color `String`. For `section` objects, data values must be a `String`, and the `section` object must have a `set` method defined.
 
 The `populate_data_fields` method verifies that data attributes associated with each `UIElement` is not `nil` or `empty` before attempting to
 enter data into the `UIElement`.
@@ -634,6 +636,14 @@ The `verify_ui_states` method supports the following property/state pairs:
     :class             String
     :value or :caption String
     :attribute         Hash
+    :style             String
+    :tabindex          Integer
+    :required          Boolean
+
+**Pages:**
+
+    :secure Boolean
+    :title  String
 
 **Text Fields:**
 
@@ -646,12 +656,17 @@ The `verify_ui_states` method supports the following property/state pairs:
 
 **Checkboxes:**
 
-    :checked Boolean
+    :checked       Boolean
+    :indeterminate Boolean
 
 **Radio Buttons:**
 
     :selected Boolean
 
+**Links:**
+
+    :href String
+
 **Images**
 
     :loaded Boolean
@@ -671,6 +686,8 @@ The `verify_ui_states` method supports the following property/state pairs:
     :items or :options         Array of Strings
     :itemcount or :optioncount Integer
     :selected                  String
+    :groupcount                Integer
+    :group_headings            Array of Strings
 
 **Tables**
 
@@ -706,8 +723,6 @@ The `verify_ui_states` method supports the following property/state pairs:
 
 The `verify_ui_states` method supports the following ARIA accessibility property/state pairs:
 
-**All Objects:**
-
     :aria_label           String
     :aria_disabled        Boolean
     :aria_labelledby      String
@@ -738,8 +753,10 @@ The `verify_ui_states` method supports the following ARIA accessibility property
     :aria_multiline       Boolean
     :aria_multiselectable Boolean
     :content_editable     Boolean
+    :role                 String
 
 #### Comparison States
+
 The `verify_ui_states` method supports comparison states using property/comparison state pairs:
 
     object => { property: { comparison_state: value } }
@@ -844,6 +861,126 @@ Baseline translation strings are stored in `.yml` files in the `config/locales/`
         └── README.md
 
 
+### Working with custom UIElements
+
+Many responsive and touch-enabled web based user interfaces are implemented using front-end JavaScript libraries for building user
+interfaces based on UI components. Popular JS libraries include React, Angular, and Ember.js. These stylized and adorned controls can
+present a challenge when attempting to interact with them using Capybara and Selenium based automated tests.
+
+#### Radio and Checkbox UIElements
+
+Sometimes, radio buttons and checkboxes implemented using JS component libraries cannot be interacted with due to other UI elements
+being overlaid on top of them and the base `input(type='radio')` or `input(type='checkbox')` element not being visible.
+
+In the screenshots below of an airline flight search and booking page, the **Roundtrip** and **One-way** radio buttons are adorned with
+`label` elements that also acts as proxies for their associated `input(type='radio')` elements, and they intercept the `click` actions
+that would normally be handled by the `input(type='radio')` elements.
+
+<img src="https://i.imgur.com/7bW5u4c.jpg" alt="Roundtrip Radio button Input" title="Roundtrip Radio button Input">
+
+
+This screenshot shows the `label` element that is overlaid above the **Roundtrip** `input(type='radio')` element.
+
+<img src="https://i.imgur.com/2stWiyR.jpg" alt="Roundtrip Radio button Label" title="Roundtrip Radio button Label">
+
+
+The checkbox controls in this web UI are also adorned with `label` elements that act as proxies for their associated `input(type='checkbox')`
+elements.
+
+<img src="https://i.imgur.com/JcOANqZ.jpg" alt="One-way Radio button Label" title="One-way Radio button Label">
+
+
+The `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods provide a way to specify the `proxy` and/or `label`
+elements associated with the `input(type='radio')` or `input(type='checkbox')` elements. The `define_custom_elements` method
+should be called from an `initialize` method for the `PageObject` or `PageSection` where the `radio` or `checkbox` element is instantiated.
+The code snippet below demonstrates the use of the `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods to
+resolve the testability issues posed by the adorned **Roundtrip** and **One-way** radio buttons and the **Flexible dates** checkbox.
+
+    class FlightBookingPage < TestCentricity::PageObject
+      trait(:page_name)    { 'Flight Booking Home' }
+      trait(:page_locator) { "div[class*='bookerContainer']" }
+      
+      # Flight Booking page UI elements
+      radios   roundtrip_radio: 'input#roundtrip',
+               one_way_radio:   'input#oneway'
+      checkbox :flexible_check, 'input#flexibleDates'
+      
+      def initialize
+        # define the custom element components for the Round Trip radio button
+        radio_spec = { proxy: "label[for='roundtrip']" }
+        roundtrip_radio.define_custom_elements(radio_spec)
+        # define the custom element components for the One Way radio button
+        radio_spec = { proxy: "label[for='oneway']" }
+        one_way_radio.define_custom_elements(radio_spec)
+        # define the custom element components for the Flexible Date checkbox
+        check_spec = { proxy: 'label#flexDatesLabel' }
+        flexible_check.define_custom_elements(check_spec)
+      end
+    end
+
+
+#### SelectList UIElements
+
+The basic HTML `select` element is typically composed of the parent `select` object, and one or more `option` elements representing
+the selectable items in the drop-down list. However, `select` type controls implemented using JS component libraries can be composed
+of multiple elements representing the various components of a drop-down style `selectlist` implementation.
+
+In the screenshots below of an airline flight search and booking page, there are no `select` or `option` elements associated with the
+**Month**, **Day**, and **Cabin Type** drop-down style selectors. An inspection of the **Month** selector reveals that it is a `div`
+element that contains a `button` element (outlined in red) for triggering the drop-down list, a `ul` element (outlined in green) that
+contains the drop-down list, and multiple `li` elements (outlined in blue) that represent the list items or options that can be
+selected. The currently selected item or option can be identified by either the `listBoxOptionSelected` snippet in its `class` name or
+the `aria-selected` attribute (outlined in orange).
+
+Further examination of the **Day** and **Cabin Type** drop-down style selectors reveal that their composition is identical to the
+**Month** selector.
+
+<img src="https://i.imgur.com/LYAC2lh.jpg" alt="Custom SelectList" title="Custom SelectList">
+
+
+The `SelectList.define_list_elements` method provides a means of specifying the various elements that make up the key components of
+a `selectlist` control. The method accepts a hash of element designators (key) and a CSS or Xpath expression (value) that expression
+that uniquely identifies the element. Valid element designators are `list_item:`, `options_list:`, `list_trigger:`, `selected_item:`,
+`text_field:`, `group_heading:`, and `group_item:`.
+
+The code snippet below demonstrates the use of the `SelectList.define_list_elements` method to define the common components that make
+up the **Month**, **Day**, and **Cabin Type** drop-down style selectors. Note the use of the ARIA `role` and `aria-selected` attributes
+as element locators.
+
+    class FlightBookingPage < TestCentricity::PageObject
+      trait(:page_name)    { 'Flight Booking Home' }
+      trait(:page_locator) { "div[class*='bookerContainer']" }
+      
+      # Flight Booking page UI elements
+      selectlists month_select:      "div[class*='expandFlexMonth']",
+                  duration_select:   "div[class*='expandFlexDay']",
+                  cabin_type_select: "div[class*='bookFlightForm__optionField'] > div[class*='app-components-ListBox']"
+
+      def initialize
+        # define the custom list element components for the Month, Duration, and Cabin Type selectlist objects
+        list_spec = {
+          selected_item: "li[aria-selected=true]",
+          options_list:  "ul[role='listbox']",
+          list_item:     "li[role='option']",
+          list_trigger:  "button[role='combobox']"
+        }
+        month_select.define_list_elements(list_spec)
+        duration_select.define_list_elements(list_spec)
+        cabin_type_select.define_list_elements(list_spec)
+      end
+    end
+
+
+#### List UIElements
+
+The basic HTML list is typically composed of the parent `ul` object, and one or more `li` elements representing the items
+in the list. However, list controls implemented using JS component libraries can be composed of multiple elements representing the
+components of a list implementation.
+
+The `List.define_list_elements` method provides a means of specifying the elements that make up the key components of a `list` control.
+The method accepts a hash of element designators (key) and a CSS or Xpath expression (value) that expression that uniquely identifies
+the element. Valid element designators are `list_item:`and `selected_item:`.
+
 
 ## Instantiating your PageObjects
 
@@ -1220,7 +1357,7 @@ Once your test environment is properly configured, the following **Environment V
 | `WEB_BROWSER`              | Must be set to `appium`                                                                                                                                               |
 | `APP_PLATFORM_NAME`        | Must be set to `iOS`                                                                                                                                                  |
 | `APP_BROWSER`              | Must be set to `Safari`                                                                                                                                               |
-| `APP_VERSION`              | Must be set to `15.2`, `14.5`, or which ever iOS version you wish to run within the XCode Simulator                                                                   |
+| `APP_VERSION`              | Must be set to `15.4`, `14.5`, or which ever iOS version you wish to run within the XCode Simulator                                                                   |
 | `APP_DEVICE`               | Set to iOS device name supported by the iOS Simulator (`iPhone 13 Pro Max`, `iPad Pro (12.9-inch) (5th generation)`, etc.) or name of physically connected iOS device |
 | `DEVICE_TYPE`              | Must be set to `phone` or `tablet`                                                                                                                                    |
 | `APP_UDID`                 | UDID of physically connected iOS device (not used for simulators)                                                                                                     |
@@ -1302,6 +1439,13 @@ the code shown below in your `hooks.rb` file.
     end
 
 
+The `APPIUM_SERVER` environment variable must be set to `run` in order to programmatically start and stop Appium server. This can be
+set by adding the following to your `cucumber.yml` file and including `-p run_appium` in your command line when starting your Cucumber
+test suite(s):
+
+    run_appium: APPIUM_SERVER=run
+
+
 Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
 
 
@@ -1548,9 +1692,10 @@ that you intend to connect with.
     #==============
 
     appium_ios: WEB_BROWSER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false
-    app_ios_15: --profile appium_ios APP_VERSION="15.2"
-    ipad_pro_12_9_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)" <%= desktop %>
-    ipad_air_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Air (4th generation)" <%= desktop %>
+    app_ios_15: --profile appium_ios APP_VERSION="15.4"
+    ipad_pro_12_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)"
+    ipad_air_15_sim:    --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Air (5th generation)" <%= desktop %>
+    ipad_15_sim:        --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad (9th generation)"
 
 
     #==============
@@ -1683,16 +1828,16 @@ in landscape orientation:
     cucumber -p ipad_pro -p landscape
 
 
-The following command specifies that Cucumber will run tests against an iPad Pro (12.9-inch) (5th generation) with iOS version 15.2 in an
+The following command specifies that Cucumber will run tests against an iPad Pro (12.9-inch) (5th generation) with iOS version 15.4 in an
 XCode Simulator in landscape orientation:
     
-    cucumber -p ipad_pro_12_9_15_sim -p landscape
+    cucumber -p ipad_pro_12_15_sim -p landscape
     
     NOTE:  Appium must be running prior to executing this command
 
 You can ensure that Appium Server is running by including `-p run_appium` in your command line:
 
-    cucumber -p ipad_pro_12_9_15_sim -p landscape -p run_appium
+    cucumber -p ipad_pro_12_15_sim -p landscape -p run_appium
 
 
 The following command specifies that Cucumber will run tests against a remotely hosted Safari web browser running on a macOS Monterey

data/Rakefile

@@ -1 +1,60 @@
-require 'bundler/gem_tasks'
+require 'rubygems'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'rake'
+
+
+namespace :features do
+  Cucumber::Rake::Task.new(:edge_local) do |t|
+    t.profile = 'edge_local'
+  end
+
+  Cucumber::Rake::Task.new(:chrome_local) do |t|
+    t.profile = 'chrome_local'
+  end
+
+  Cucumber::Rake::Task.new(:edge_headless) do |t|
+    t.profile = 'edge_headless'
+  end
+
+  Cucumber::Rake::Task.new(:chrome_headless) do |t|
+    t.profile = 'chrome_headless'
+  end
+
+  Cucumber::Rake::Task.new(:safari_local) do |t|
+    t.profile = 'safari_local'
+  end
+
+  Cucumber::Rake::Task.new(:firefox_local) do |t|
+    t.profile = 'firefox_local'
+  end
+
+  Cucumber::Rake::Task.new(:firefox_headless) do |t|
+    t.profile = 'firefox_headless'
+  end
+
+  Cucumber::Rake::Task.new(:edge_grid) do |t|
+    t.profile = 'edge_grid'
+  end
+
+  Cucumber::Rake::Task.new(:chrome_grid) do |t|
+    t.profile = 'chrome_grid'
+  end
+
+  Cucumber::Rake::Task.new(:firefox_grid) do |t|
+    t.profile = 'firefox_grid'
+  end
+
+  Cucumber::Rake::Task.new(:ios_remote) do |t|
+    t.profile = 'ios_remote'
+  end
+
+
+  task :required => [:edge_local, :edge_headless, :chrome_local, :chrome_headless, :safari_local]
+
+  task :grid => [:edge_grid, :chrome_grid]
+
+  task :mobile => [:ios_remote]
+
+  task :all => [:edge_local, :edge_headless, :chrome_local, :chrome_headless, :safari_local, :edge_grid, :chrome_grid, :ios_remote]
+end