testcentricity_web 3.0.1 → 3.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 75c1e711abee33a40b8824e4e1c49d9f08802f49
-  data.tar.gz: 384be28bacdc6861daacdc08cc9a43188c03a428
+  metadata.gz: 258399cf7a4c2ad149538baca9fa69094f38449e
+  data.tar.gz: b94b98ce6a4201ef55070e6be807025240c16081
 SHA512:
-  metadata.gz: e9c50e28867b62bc65088ba285297d43d06a22571061517c34ddbdeea1a25904d5363649303254b7e284bcf1553173b80e93d781543679e56a258346a180f2b7
-  data.tar.gz: 9ad61cdac26f2d4c5a99c07b0a7d8b949abb735a267b069fe061e9a7f647675cb9fe579f2f606e196318685b0b818791e6ad23f22445454df95522fc4dd30d5d
+  metadata.gz: 1d5494b53c342db2401efb2da4d34887c11ec1e0f614b339dbfc9ef8fe974a3731ec54fc50a9924052d1fdab280981aca9b6b7883816843b3b4670b78ca6528a
+  data.tar.gz: e598693e32cddfa5004b18fbf08f1de60dd8156d4dfdd11408ca9555245ba5033560e1499494f5629f7f0e098d76b268f62e8c7a02f550a48b2084f5b7449df1

data/.yardopts

@@ -1,2 +1,3 @@
 --markup markdown
---markup-provider redcarpet
+--markup-provider redcarpet
+--no-private - README.md HISTORY.md LICENSE.md

data/HISTORY.md

@@ -1,4 +1,8 @@
 
+###Version 3.0.2
+
+* `PageManager.find_page` method now raises an exception if the requested page object has not been defined and instantiated.
+
 ###Version 3.0.1
 
 * Updated device profiles for iPhone 7 (iOS 11) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.

data/README.md

@@ -11,7 +11,7 @@ An example project that demonstrates the implementation of a page object model f
 The TestCentricity™ Web gem supports running automated tests against the following web test targets:
 * locally hosted desktop browsers (Firefox, Chrome, Safari, or IE)
 * locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within a local instance of Chrome)
-* locally hosted headless Chrome or Firefox browsers
+* locally hosted "headless" Chrome or Firefox browsers
 * mobile Safari browsers on iOS device simulators or physical iOS devices (using Appium and XCode on OS X)
 * mobile Chrome or Android browsers on Android Studio virtual device emulators (using Appium and Android Studio on OS X)
 * cloud hosted desktop (Firefox, Chrome, Safari, IE, or Edge) or mobile (iOS Mobile Safari or Android) web browsers using the [Browserstack](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate),
@@ -22,6 +22,13 @@ The TestCentricity™ Web gem supports running automated tests against the follo
 
 
 ## What's New
+
+A complete history of bug fixes and new features can be found in the {file:docs/HISTORY.html HISTORY} file.
+
+###Version 3.0.2
+
+* `PageManager.find_page` method now raises an exception if the requested page object has not been defined and instantiated.
+
 ###Version 3.0.1
 
 * Updated device profiles for iPhone 7 (iOS 11) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
@@ -38,202 +45,6 @@ versions of Firefox web browsers.
 * `TestCentricity::WebDriverConnect.set_webdriver_path` method now sets the path to the appropriate **geckodriver** file for OS X or Windows when testing on
 locally hosted Firefox browsers.
 
-###Version 2.4.3
-
-* Updated device profiles for iPhone 7 (iOS 11) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.4.1
-
-* Added device profiles for iPad (iOS 10) with MS Edge browser.
-
-###Version 2.4.0
-
-* Updated `TestCentricity::WebDriverConnect.initialize_web_driver` method to read the `APP_FULL_RESET`, `APP_NO_RESET`, and `NEW_COMMAND_TIMEOUT` Environment
-Variables and set the corresponding `fullReset`, `noReset`, and `newCommandTimeout` Appium capabilities for iOS and Android physical devices and simulators.
-Also reads the `WDA_LOCAL_PORT` Environment Variable and sets the `wdaLocalPort` Appium capability for iOS physical devices only.
-
-###Version 2.3.18
-
-* Updated `SelectList.define_list_elements` method to accept value for `:list_trigger` element.
-* Updated `SelectList.choose_option` to respect `:list_item` value and to click on `:list_trigger` element, if one is specified.
-* Updated `PageSection` and `PageObject` UI element object declaration methods to no longer use `class_eval` pattern.
-* Updated device profiles for iPhone 7 (iOS 10) with Chrome browser and iPad (iOS 10) with Chrome browser.
-
-###Version 2.3.17
-
-* Added `List.wait_until_item_count_is` and `List.wait_until_item_count_changes` methods.
-* `UIElement.wait_until_value_is` and `List.wait_until_item_count_is` methods now accept comparison hash.
-
-###Version 2.3.16
-
-* Added `PageSection.double_click`, `PageObject.right_click`, and `PageObject.send_keys` methods.
-
-###Version 2.3.15
-
-* Added `PageObject.wait_until_exists` and `PageObject.wait_until_gone` methods.
-
-###Version 2.3.14
-
-* Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser.
-
-###Version 2.3.13
-
-* Added `AppiumServer.start`, `AppiumServer.running?`, and `AppiumServer.stop` methods for starting and stopping the Appium Server prior to executing tests on
-iOS physical devices or simulators, or Android virtual device emulators.
-
-###Version 2.3.12
-
-* Added `Environ.is_simulator?` and `Environ.is_web?` methods.
-
-###Version 2.3.11
-
-* Added support for running tests in Mobile Safari browser on physical iOS devices.
-* Updated device profiles for iPhone 7 (iOS 10) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.3.10
-
-* Added support for running tests in mobile Chrome or Android browsers on Android Studio virtual device emulators.
-* Added `displayed?`, `get_all_items_count`, and `get_all_list_items` methods to `PageSection` class.
-* Added `get_all_items_count`, and `get_all_list_items` methods to `List` class.
-
-###Version 2.3.9
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to accept optional `wait_time` parameter.
-* Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser, iPhone 7 (iOS 10) with Chrome browser, and iPhone 7 (iOS 10) with Firefox browser.
-* Updated device profiles for iPad (iOS 10) with Chrome browser and iPad (iOS 10) with Firefox browser.
-
-###Version 2.3.7
-
-* Added `width`, `height`, `x`, `y`, and `displayed?` methods to `UIElement` class.
-
-###Version 2.3.6
-
-* Added `TextField.clear` method for deleting the contents of text fields. This method should trigger the `onchange` event for the associated text field.
-
-###Version 2.3.5
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to be compatible with Redactor editor fields.
-* Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser, iPhone 7 (iOS 10) with Chrome browser, and iPhone 7 (iOS 10) with Firefox browser.
-
-###Version 2.3.3
-
-* Added device profile for iPhone 7 (iOS 10) with MS Edge browser.
-
-###Version 2.3.1
-
-* When testing using remotely hosted browsers on the BrowserStack service, the BrowserStack Local instance is automatically started if the `TUNNELING`
-Environment Variable is set to `true`. `Environ.tunneling` will be set to true if the BrowserStack Local instance is succesfully started.
-* Added `TestCentricity::WebDriverConnect.close_tunnel` method to close BrowserStack Local instance when Local testing is enabled. Refer to the
-**Remotely hosted desktop and mobile web browsers** section for information on usage.
-
-###Version 2.2.0
-
-* CSS selectors or XPath expressions may be used as locators for all types of **UI Elements**, including tables.
-
-###Version 2.1.10
-
-* Added device profiles for iPhone 7 (iOS 10) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.1.8
-
-* Added `PageSection.verify_list_items` method for **Indexed PageSection Objects**.
-
-###Version 2.1.7
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to use backspace characters to delete contents of a textfield
-instead of using `clear`, which was preventing `onchange` JavaScript events from being triggered in some browsers.
-
-###Version 2.1.5
-
-* Added `get_min`, `get_max`, and `get_step` methods to `TextField` class.
-
-* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of `min`, `max`, and `step` attributes
-for textfields.
-
-###Version 2.1.4
-
-* Added suppression of the Info Bar that displays "Chrome is being controlled by automated test software" on locally hosted instances of the Chrome browser.
-
-
-###Version 2.1.3
-
-* Added support for "tiling" or cascading multiple browser windows when the `BROWSER_TILE` and `PARALLEL` Environment Variables are set to true. For each
-concurrent parallel thread being executed, the position of each browser will be offset by 100 pixels right and 100 pixels down. For parallel test execution,
-use the [parallel_tests gem](https://rubygems.org/gems/parallel_tests) to decrease overall test execution time.
-
-###Version 2.1.2
-
-* Added device profiles for Microsoft Lumia 950, Blackberry Leap, Blackberry Passport, and Kindle Fire HD 10
-* Added ability to set browser language support via the `LOCALE` Environment Variable for local instances of Chrome browsers
-
-###Version 2.1.0
-
-* Added device profiles for iPhone 8, iPhone 8 Plus, iPhone X devices running iOS 11
-* Added device profile for iPad Pro 10.5" with iOS 11
-* Updated iPhone 7 and iPhone 7 Plus profiles to iOS 10
-* Updated Google Pixel and Google Pixel XL profiles to Android 8
-* Added device profiles for iPhone 7 (iOS 10) with Mobile Chrome browser and iPad (iOS 10) with Mobile Chrome browser
-
-
-## What's Fixed
-###Version 2.3.19
-
-* Fixed device profile for `android_phone` - Generic Android Phone.
-
-###Version 2.3.18
-
-* Fixed `SelectList.choose_option` to also accept `:text`, `:value`, and `:index` option hashes across all types of select list objects.
-
-###Version 2.3.15
-
-* Fixed bug in `UIElement.get_object_type` method that could result in a `NoMethodError obj not defined` error.
-* Fixed bug in `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods that failed to enqueue errors when UI elements could not be found.
-
-###Version 2.3.8
-
-* Fixed locator resolution for **Indexed PageSection Objects**.
-
-###Version 2.3.6.1
-
-* `TextField.clear` method now works with most `number` type fields.
-
-###Version 2.3.4
-
-* Fixed bug in `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods that prevented deletion of data in number type textfields
-and textarea controls.
-
-###Version 2.3.3
-
-* Corrected device profiles for iPad (iOS 10) with Mobile Chrome browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.2.1
-
-* `SelectList.choose_option` method now accepts index values for Chosen list objects.
-
-###Version 2.1.9
-
-* Fixed bug in `SelectList.choose_option`, `SelectList.get_options`, `SelectList.get_option_count`, and `SelectList.get_selected_option` methods which
-did not recognize grouped option in Chosen list objects.
-
-###Version 2.1.6
-
-* Fixed bug in `TestCentricity::WebDriverConnect.set_webdriver_path` method that was failing to set the path to the appropriate **chromedriver** file for OS X
-and Windows.
-
-###Version 2.1.5
-
-* Fixed Chrome and Firefox support for setting browser language via the `LOCALE` Environment Variable. This capability now works for emulated mobile
-browsers hosted in a local instance of Chrome or Firefox.
-
-###Version 2.1.0
-
-* The `TestCentricity::WebDriverConnect.initialize_web_driver` method now sets the `Environ` object to the correct device connection states for local and
-cloud hosted browsers.
-* The `TestCentricity::WebDriverConnect.initialize_web_driver` method no longer calls `initialize_browser_size` when running tests against cloud hosted
-mobile web browser, which was resulting in Appium throwing exceptions for unsupported method calls.
-* The `TestCentricity::WebDriverConnect.set_webdriver_path` method now correctly sets the path for Chrome webDrivers when the `HOST_BROWSER` Environment
-Variable is set to `chrome`. Tests against locally hosted emulated mobile web browser running on a local instance of Chrome will now work correctly.
-
 
 ## Installation
 
@@ -496,7 +307,7 @@ the UI to hide implementation details, as shown below:
 Once your **Page Objects** have been instantiated, you can call your methods as shown below:
 
     login_page.remember_me(true)
-    login_page.user_id_field.set('snicklefritz', 'Pa55w0rd')
+    login_page.login('snicklefritz', 'Pa55w0rd')
     
 
 
@@ -797,7 +608,7 @@ navigated to by clicking associated links. One such Cucumber navigation scenario
         |FAQs                    |
         |Contact Us              |
 
-In the above example, the step definitions associated with the 3 steps might be implemented using a page_dispatcher method using a
+In the above example, the step definitions associated with the 3 steps might be implemented using a `page_dispatcher` method using a
 `case` statement to parse the `page` parameter as in the example below:
 
     Given(/^I am on the ([^\"]*) page$/) do |page_name|
@@ -849,37 +660,24 @@ To use these **PageManager** methods, include the step definitions and code belo
     include TestCentricity
     
     Given(/^I am on the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.load_page if target_page
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
+      target_page = PageManager.find_page(page_name)
+      target_page.load_page
     end
     
-    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
-      target_page = page_dispatcher(link_name)
-      target_page.navigate_to if target_page
+    When(/^I click the ([^\"]*) navigation link$/) do |page_name|
+      target_page = PageManager.find_page(page_name)
+      target_page.navigate_to
     end
     
     Then(/^I expect to see the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.verify_page_exists if target_page
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
+      target_page = PageManager.find_page(page_name)
+      target_page.verify_page_exists
     end
     
     Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
-      target_page = page_dispatcher(page_name)
+      target_page = PageManager.find_page(page_name)
       target_page.verify_page_exists
       target_page.verify_page_ui
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
-    end
-    
-    # this method takes a page name as a parameter and returns an instance of the associated Page Object
-    def page_dispatcher(page_name)
-      page = PageManager.find_page(page_name)
-      raise "No page object defined for page named '#{page_name}'" unless page
-      page
     end
 
 
@@ -899,12 +697,16 @@ the connection.
 For locally hosted desktop web browsers running on macOS (OS X) or Windows platforms, the `WEB_BROWSER` Environment Variable must be set to one of the
 values from the table below: 
 
-`WEB_BROWSER` | **Desktop Platform**
---------------|----------------
-`firefox`     | macOS (OS X) or Windows
-`chrome`      | macOS (OS X) or Windows
-`safari`      | macOS (OS X) only
-`ie`          | Windows only
+`WEB_BROWSER`      | **Desktop Platform**
+-------------------|----------------
+`chrome`           | OS X or Windows
+`chrome_headless`  | OS X or Windows (headless - no visible UI)
+`firefox`          | OS X or Windows (Firefox version 55 or greater only)
+`firefox_headless` | OS X or Windows (headless - no visible UI)
+`firefox_legacy`   | OS X or Windows (Firefox version 47.0.1 only)
+`safari`           | OS X only
+`ie`               | Windows only (IE version 10.x or greater only)
+
 
 To set the size of a desktop browser window, you set the `BROWSER_SIZE` Environment Variable to the desired width and height in pixels as shown below:
                                                                                                                                
@@ -979,7 +781,7 @@ to `chrome`.
 
 You can run your mobile web tests against the mobile Safari browser on simulated iOS devices or physically connected iOS devices using Appium and XCode on
 OS X. You must install Appium, XCode, and the iOS version-specific device simulators for XCode. You must also ensure that the `appium_capybara` gem is
-installed and required as described in **section 2.4 (Setup - Using Appium)** above.
+installed and required as described in **section 3.3 (Setup - Using Appium)** above.
 
 Information about Appium setup and configuration requirements for testing on physically connected iOS devices can be found on [this page](https://github.com/appium/appium/blob/master/docs/en/drivers/ios-xcuitest-real-devices.md).
 The Appium server must be running prior to invoking Cucumber to run your features/scenarios.

data/lib/testcentricity_web.rb

@@ -1,5 +1,6 @@
 require 'capybara/cucumber'
 require 'test/unit'
+require 'appium_lib'
 
 require 'testcentricity_web/version'
 require 'testcentricity_web/world_extensions'
@@ -77,7 +78,9 @@ module TestCentricity
 
     def self.find_page(page_name)
       (page_name.is_a? String) ? page_id = page_name.gsub(/\s+/, '').downcase.to_sym : page_id = page_name
-      @page_objects[page_id]
+      page = @page_objects[page_id]
+      raise "No page object defined for page named '#{page_name}'" unless page
+      page
     end
 
     # Get the currently active PageObject

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.0.1'
+  VERSION = '3.0.2'
 end

data/lib/testcentricity_web/web_elements/textfield.rb

@@ -100,10 +100,7 @@ module TestCentricity
           send_keys(:backspace)
         end
         sleep(0.5)
-        send_keys(:tab)
-        sleep(0.5)
-        length = get_value.length
-        if length > 0
+        if get_value.length > 0
           set('')
           sleep(0.5)
           send_keys(:tab)

data/testcentricity_web.gemspec

@@ -40,6 +40,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'os'
   spec.add_dependency 'i18n'
   spec.add_dependency 'browserstack-local'
+  spec.add_dependency 'appium_lib'
 
   spec.add_runtime_dependency 'childprocess', '~> 0.5'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.0.2
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-28 00:00:00.000000000 Z
+date: 2018-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -164,6 +164,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: appium_lib
+  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: childprocess
   requirement: !ruby/object:Gem::Requirement