testcentricity_web 4.1.5 → 4.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 022bc17f6fc489c52de9a91fdccb61b722db97cb17b2c21951a2650930adeeb8
-  data.tar.gz: cfeefd68b74714b35b738f865b8c5796d4ebe3c302bed0deff208cef34d4f225
+  metadata.gz: 98ea25aaf7cff4f07b966b6cac829a2cd6ad3234403e3a01257ff6dd07beaf38
+  data.tar.gz: 20082c59c2d9f7c5e69959500b4bc97e10f1dc93309f1ec601acdf7b0cf8d29c
 SHA512:
-  metadata.gz: 19bb489e029052084ba7c4d3c29bc7a1a5f483039624048860be14ba75d2e8960667410ac7b838a962eac263cd80bb0bf66e881b592f03ce91bcd3ebd45c2e15
-  data.tar.gz: 2f45f5c2dda5f485a123527c394f5480e91f1bb123c58efe1a7bf56225388bb0cbed82abbf0c01618d6c370ac7cd6b03f350a338025e06da5597b19989e849b2
+  metadata.gz: 40ccfaa119abc07f1bb3254cf05e2c3b5d28548b92c65da43faabc3b524af4b074973767e79da7901de09a609ee95af65e3525ea60b49dd3676b88a6956e7478
+  data.tar.gz: 1959d24e265fdbb21e088f4192b0de5a86f227d22b0b73870a0ab2ed12430d2b898718d2fcbb4b4330f8ec689bef770d09b3cefa39ec0a0cb75b8ab624078abb

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,20 @@
 All notable changes to this project will be documented in this file.
 
 
+## [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

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (4.1.5)
+    testcentricity_web (4.1.6)
       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
@@ -47,22 +51,62 @@ GEM
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
     concurrent-ruby (1.1.9)
+    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

@@ -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`.
@@ -636,6 +638,12 @@ The `verify_ui_states` method supports the following property/state pairs:
     :attribute         Hash
     :style             String
     :tabindex          Integer
+    :required          Boolean
+
+**Pages:**
+
+    :secure Boolean
+    :title  String
 
 **Text Fields:**
 
@@ -1820,7 +1828,7 @@ 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_15_sim -p landscape

data/Rakefile

@@ -1 +1,37 @@
-require 'bundler/gem_tasks'
+require 'rubygems'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'rake'
+
+
+namespace :features do
+  Cucumber::Rake::Task.new(:edge) do |t|
+    t.profile = 'edge'
+  end
+
+  Cucumber::Rake::Task.new(:chrome) do |t|
+    t.profile = 'chrome'
+  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) do |t|
+    t.profile = 'safari'
+  end
+
+  Cucumber::Rake::Task.new(:firefox) do |t|
+    t.profile = 'firefox'
+  end
+
+  Cucumber::Rake::Task.new(:firefox_headless) do |t|
+    t.profile = 'firefox_headless'
+  end
+
+  task :all => [:edge, :edge_headless, :chrome, :chrome_headless, :safari]
+end

data/config/cucumber.yml

@@ -0,0 +1,150 @@
+<% desktop = "--require features BROWSER_TILE=true BROWSER_SIZE=1300,1000 --publish-quiet" %>
+<% tablet  = "--tags @desktop --require features BROWSER_TILE=true --publish-quiet" %>
+<% mobile    = "--tags @mobile  --require features BROWSER_TILE=true --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" %>
+
+
+#==============
+# 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)'
+
+
+#==============
+# test reporting profiles
+#==============
+
+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
+
+
+#==============
+# profiles for locally hosted desktop web browsers
+#==============
+
+chrome:  WEB_BROWSER=chrome <%= desktop %>
+firefox: WEB_BROWSER=firefox <%= desktop %>
+edge:    WEB_BROWSER=edge <%= desktop %>
+safari:  WEB_BROWSER=safari <%= desktop %>
+
+firefox_headless: WEB_BROWSER=firefox_headless <%= desktop %>
+chrome_headless:  WEB_BROWSER=chrome_headless <%= desktop %>
+edge_headless:    WEB_BROWSER=edge_headless <%= desktop %>
+
+
+#==============
+# profile for Selenium Grid and Dockerized Selenium Grid hosted desktop web browsers
+#==============
+grid: SELENIUM=remote REMOTE_ENDPOINT="http://localhost:4444/wd/hub"
+
+
+#==============
+# 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
+
+
+#==============
+# profiles for mobile Safari web browsers hosted within XCode iOS simulators
+# NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
+#==============
+
+appium_ios: WEB_BROWSER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false <%= 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 %>
+
+
+#==============
+# profiles for Android mobile web browsers hosted within Android Studio Android Virtual Device emulators
+# NOTE: Requires installation of Android Studio, Android version specific virtual device simulators, Appium, and the appium_capybara gem
+#==============
+
+appium_android:    WEB_BROWSER=appium APP_PLATFORM_NAME="Android" <%= desktop %>
+app_android_12:    --profile appium_android APP_BROWSER="Chrome" APP_VERSION="12.0"
+pixel_c_api31_sim: --profile app_android_12 DEVICE_TYPE=tablet APP_DEVICE="Pixel_C_API_31"
+
+
+#==============
+# profiles for remotely hosted web browsers on the BrowserStack service
+#==============
+
+browserstack: WEB_BROWSER=browserstack BS_USERNAME="<INSERT USER NAME HERE>" BS_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TC_Web_Sample - BrowserStack"
+bs_desktop:   --profile browserstack <%= desktop %> RESOLUTION="1920x1080"
+bs_mobile:    --profile browserstack <%= mobile %>
+
+# BrowserStack macOS desktop browser profiles
+bs_macos_monterey:  --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Monterey"
+bs_chrome_monterey: --profile bs_macos_monterey BS_BROWSER="Chrome" BS_VERSION="latest"
+bs_edge_monterey:   --profile bs_macos_monterey BS_BROWSER="Edge" BS_VERSION="latest"
+bs_safari_monterey: --profile bs_macos_monterey BS_BROWSER="Safari" BS_VERSION="latest"
+
+# BrowserStack iOS mobile browser profiles
+bs_ipad:        --profile bs_mobile BS_OS=ios BS_BROWSER=Safari DEVICE_TYPE=tablet BS_REAL_MOBILE="true"
+bs_ipad_pro_12: --profile bs_ipad BS_DEVICE="iPad Pro 12.9 2018" BS_OS_VERSION="15"
+
+# BrowserStack Android mobile browser profiles
+bs_android:        --profile bs_mobile BS_OS=android BS_BROWSER=Chrome DEVICE_TYPE=tablet BS_REAL_MOBILE="true"
+bs_android_tablet: --profile bs_android BS_DEVICE="Samsung Galaxy Tab S7" BS_OS_VERSION="10.0"
+
+
+#==============
+# profiles for remotely hosted web browsers on the LambdaTest service
+#==============
+
+lambdatest: WEB_BROWSER=lambdatest LT_USERNAME="<INSERT USER NAME HERE>" LT_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TC_Web_Sample - LambdaTest"
+lt_desktop: --profile lambdatest <%= desktop %> RESOLUTION="2560x1440"
+
+# LambdaTest macOS desktop browser profiles
+lt_macos_monterey:  --profile lt_desktop LT_OS="MacOS Monterey"
+lt_chrome_monterey: --profile lt_macos_monterey LT_BROWSER="Chrome" LT_VERSION="98.0"
+lt_edge_monterey:   --profile lt_macos_monterey LT_BROWSER="MicrosoftEdge" LT_VERSION="97.0"
+
+
+#==============
+# profiles for remotely hosted web browsers on the TestingBot service
+#==============
+
+testingbot: WEB_BROWSER=testingbot TB_USERNAME="<INSERT USER NAME HERE>" TB_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TC_Web_Sample - TestingBot"
+tb_desktop: --profile testingbot <%= desktop %> RESOLUTION="1920x1200"
+
+# TestingBot macOS desktop browser profiles
+tb_macos_monterey:  --profile tb_desktop TB_OS="MONTEREY"
+tb_chrome_monterey: --profile tb_macos_monterey TB_BROWSER="chrome" TB_VERSION="latest"
+tb_edge_monterey:   --profile tb_macos_monterey TB_BROWSER="microsoftedge" TB_VERSION="latest"
+
+
+#==============
+# profiles for remotely hosted web browsers 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="TC_Web_Sample - SauceLabs"
+sl_desktop: --profile saucelabs <%= desktop %>
+sl_mobile:  --profile saucelabs <%= mobile %>
+
+# SauceLabs macOS desktop browser profiles
+sl_macos_monterey:  --profile sl_desktop SL_OS="macOS 12" RESOLUTION="1920x1440"
+sl_chrome_monterey: --profile sl_macos_monterey SL_BROWSER="chrome" SL_VERSION="latest"
+sl_edge_monterey:   --profile sl_macos_monterey SL_BROWSER="MicrosoftEdge" SL_VERSION="latest"
+sl_firefox_monterey: --profile sl_macos_monterey SL_BROWSER="Firefox" SL_VERSION="latest"
+
+# SauceLabs Windows desktop browser profiles
+sl_windows:    --profile sl_desktop RESOLUTION="1920x1200"
+sl_edge_win11: --profile sl_windows SL_OS="Windows 11" SL_BROWSER="MicrosoftEdge" SL_VERSION="latest"
+sl_ie_win10:   --profile sl_windows SL_OS="Windows 10" SL_BROWSER="internet explorer" SL_VERSION="11"
+
+# SauceLabs iOS mobile browser profiles
+sl_ipad:        --profile sl_mobile DEVICE_TYPE=tablet SL_PLATFORM=iOS SL_BROWSER=Safari
+sl_ipad_pro_12: --profile sl_ipad SL_DEVICE="iPad Pro (12.9 inch) (5th generation) Simulator" SL_VERSION="15.0"

data/docker-compose-v3.yml

@@ -0,0 +1,48 @@
+# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3.yml up`
+# Add the `-d` flag at the end for detached execution
+# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3.yml down`
+version: "3"
+services:
+  chrome:
+    image: selenium/node-chrome:4.1.2-20220217
+    shm_size: 2gb
+    depends_on:
+      - selenium-hub
+    environment:
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+      - SE_NODE_MAX_SESSIONS=4
+      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
+
+  edge:
+    image: selenium/node-edge:4.1.2-20220217
+    shm_size: 2gb
+    depends_on:
+      - selenium-hub
+    environment:
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+      - SE_NODE_MAX_SESSIONS=4
+      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
+
+  firefox:
+    image: selenium/node-firefox:4.1.2-20220217
+    shm_size: 2gb
+    depends_on:
+      - selenium-hub
+    environment:
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+      - SE_NODE_MAX_SESSIONS=4
+      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
+
+  selenium-hub:
+    image: selenium/hub:4.1.2-20220217
+    container_name: selenium-hub
+    ports:
+      - "4442:4442"
+      - "4443:4443"
+      - "4444:4444"

data/features/basic_test_page_css.feature

@@ -0,0 +1,24 @@
+Feature: Basic HTML Test Page using CSS locators
+  In order to xxx
+  As a xxxx
+  I expect to xxxx
+
+
+  Background:
+    Given I am on the Basic CSS Test page
+
+
+  Scenario: xxxxx
+    Then I expect the Basic CSS Test page to be correctly displayed
+
+
+@!mobile
+  Scenario: xxxxx
+    Then I expect the tab order to be correct
+
+
+  Scenario: xxxxx
+    When I populate the form fields
+    Then I expect the form fields to be correctly populated
+    When I cancel my changes
+    Then I expect the Basic CSS Test page to be correctly displayed

data/features/basic_test_page_xpath.feature

@@ -0,0 +1,24 @@
+Feature: Basic HTML Test Page using Xpath locators
+  In order to xxx
+  As a xxxx
+  I expect to xxxx
+
+
+  Background:
+    Given I am on the Basic Xpath Test page
+
+
+  Scenario: xxxxx
+    Then I expect the Basic Xpath Test page to be correctly displayed
+
+
+@!mobile
+  Scenario: xxxxx
+    Then I expect the tab order to be correct
+
+
+  Scenario: xxxxx
+    When I populate the form fields
+    Then I expect the form fields to be correctly populated
+    When I cancel my changes
+    Then I expect the Basic Xpath Test page to be correctly displayed

data/features/step_definitions/generic_steps.rb.rb

@@ -0,0 +1,37 @@
+include TestCentricity
+
+
+Given(/^I am (?:on|viewing) the (.*) page$/) do |page_name|
+  # find and load the specified target page
+  target_page = PageManager.find_page(page_name)
+  target_page.load_page
+end
+
+
+Then(/^I expect the (.*) page to be correctly displayed$/) do |page_name|
+  # find and verify that the specified target page is loaded
+  target_page = PageManager.find_page(page_name)
+  target_page.verify_page_exists
+  # verify that target page is correctly displayed
+  target_page.verify_page_ui
+end
+
+
+When(/^I populate the form fields$/) do
+  PageManager.current_page.populate_form
+end
+
+
+Then(/^I expect the form fields to be correctly populated$/) do
+  PageManager.current_page.verify_form_data
+end
+
+
+When(/^I (.*) my changes$/) do | action|
+  PageManager.current_page.perform_action(action.downcase.to_sym)
+end
+
+
+Then(/^I expect the tab order to be correct$/) do
+  PageManager.current_page.verify_tab_order
+end

data/features/support/env.rb

@@ -0,0 +1,43 @@
+require 'capybara/cucumber'
+require 'parallel_tests'
+require 'appium_capybara'
+require 'require_all'
+require 'simplecov'
+require 'testcentricity_web'
+
+SimpleCov.command_name "features #{ENV['WEB_BROWSER']}" + (ENV['TEST_ENV_NUMBER'] || '')
+
+# require_relative 'world_data'
+require_relative 'world_pages'
+
+# require_rel 'data'
+# require_rel 'sections'
+require_rel 'pages'
+
+$LOAD_PATH << './lib'
+
+# set Capybara's default max wait time to 20 seconds
+Capybara.default_max_wait_time = 20
+
+# set the default locale and auto load all translations from config/locales/*.rb,yml.
+ENV['LOCALE'] = 'en-US' unless ENV['LOCALE']
+I18n.load_path += Dir['config/locales/*.{rb,yml}']
+I18n.default_locale = ENV['LOCALE']
+I18n.locale = ENV['LOCALE']
+Faker::Config.locale = ENV['LOCALE']
+
+# instantiate all data objects and target test environment
+# include WorldData
+# environs.find_environ(ENV['TEST_ENVIRONMENT'], :yaml)
+# WorldData.instantiate_data_objects
+
+# instantiate all page objects
+include WorldPages
+WorldPages.instantiate_page_objects
+
+# establish connection to WebDriver and target web browser
+Webdrivers.cache_time = 86_400
+
+options = { app_host: "file://#{File.dirname(__FILE__)}/../../test_site" }
+options = { app_host: "http://192.168.1.129"}
+TestCentricity::WebDriverConnect.initialize_web_driver(options)