testcentricity_web 0.6.3 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 903af60024a5a7eb9ce7a906b3e0e7ea7eebcdb0
-  data.tar.gz: affa48e4dcd2fa08beec0684f93abc3a73465981
+  metadata.gz: 7d1c25417263a8e482daf9053e4f28d1fc3283e7
+  data.tar.gz: 583b938a2eaca21ead5afa17aa62a07f4303137b
 SHA512:
-  metadata.gz: ee1eb1a075e1018a78717d73777610abd6620f21a3c2d48437ceff7920d8ca8dd79cd9b0f2b456b6280977553f0b36c7cc89e6ab42c558dd0e0e2de8c86160e0
-  data.tar.gz: 43448bbe045cac832869010ec64c715f9ecbaca0880b8b20a20c9964d60fa66536601b21e71bcd1ec24a84da3fc213aa8e02bb35e9d1d87743a9f71495e1f3f9
+  metadata.gz: e68237af398f2488d7392c191f0ba51a49292873313afa4c0cda5cb237181fbec10aa33441b619726b30d873c645f4aee1ceb3ef4e1f505e9e974d0d7c5c61b1
+  data.tar.gz: bde9567c48c39a96de491e990cf1a917e22ede563efbe45210b598726c987bbc69ea7c8aa95f2c9df8da5ca96d91f5b184041a6801aa93b8091a4c29c9b3e276

data/README.md

@@ -1,18 +1,13 @@
 # TestCentricityWeb
 
 The TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object and Data Object Model DSL for
-use with Cucumber, Capybara, and selenium-webdriver.
+use with Cucumber, Capybara, and Selenium-Webdriver.
 
 The TestCentricity™ web gem supports running testing against the following web test targets:
-  * locally hosted desktop browsers (Firefox, Chrome, Safari, IE, or Edge)
-  * locally hosted emulated iOS and Android mobile browsers (using Firefox)
-  * a "headless" browser (using Poltergeist and PhantomJS)
-  * cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
-
-
-## Web Test Automation Framework Implementation
-
- <img src="http://i.imgur.com/K4XGTQi.jpg" width="1024" alt="Web Framework Overview" title="Web Framework Overview">
+- locally hosted desktop browsers (Firefox, Chrome, Safari, IE, or Edge)
+- locally hosted emulated iOS and Android mobile browsers (using Firefox)
+- a "headless" browser (using Poltergeist and PhantomJS)
+- cloud hosted desktop or mobile web browsers using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services.
 
 
 ## Installation
@@ -78,6 +73,33 @@ to update the affected feature file, scenarios, or step definitions.
 Your **Page Object** class definitions should be contained within individual *.rb* files in the ***features/support/pages*** folder of your
 test automation project. You define new **Page Objects** as shown below:
 
+    class LoginPage < TestCentricity::PageObject
+    end
+
+
+    class HomePage < TestCentricity::PageObject
+    end
+
+
+### Adding Traits to your Page Object
+
+Web pages typically have names and URLs associated with them. Web pages also typically have a unique object or attribute that, when present,
+indicates that the page's contents have fully loaded.
+
+The ***page_name*** trait is registered with the **PageManager** object, which includes a **find_page** method that takes a page name as a
+parameter and returns an instance of the associated **Page Object**.
+
+A ***page_url*** trait should be defined if a page can be directly loaded using a URL. If you set Capybara's *app_host*, or specify a base URL
+when calling the ***WebDriverConnect.initialize_web_driver*** method, then your ***page_url*** trait can be the relative URL slug that will
+be appended to the base URL specified in *app_host*. Specifying a ***page_url*** trait is optional, as not all web pages can be directly loaded
+via a URL.
+
+A ***page_locator*** trait is defined if a page has a unique object or attribute that exists once the page's contents have fully loaded. The
+***page_locator*** trait is a CSS or Xpath expression that uniquely identifies the object or attribute. The **verify_page_exists** method waits
+for the ***page_locator*** trait to exist.
+
+You define your page's **Traits** as shown below:
+
     class LoginPage < TestCentricity::PageObject
       trait(:page_name)       { 'Login' }
       trait(:page_url)        { "/sign_in" }
@@ -168,6 +190,17 @@ A **PageSection Object** may contain other **PageSection Objects**.
 Your **PageSection** class definitions should be contained within individual *.rb* files in the ***features/support/sections*** folder of
 your test automation project. You define new **PageSection Objects** as shown below:
 
+    class SearchForm < TestCentricity::PageSection
+    end
+
+
+### Adding Traits to a PageSection Object
+
+A **PageSection Object** typically has a root node object that encapsulates a collection of **UI Elements**. The ***section_locator*** trait
+specifies the CSS or Xpath expression that uniquely identifies that root node object.
+
+You define your page section's **Traits** as shown below:
+
     class SearchForm < TestCentricity::PageSection
       trait(:section_locator)    { "//form[@id='gnav-search']" }
     end
@@ -336,7 +369,8 @@ To specify the emulated device's screen orientation, you set the **ORIENTATION**
 ### Remotely hosted desktop and mobile web browsers
 
 You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting,
-Sauce Labs, or TestingBot services.
+Sauce Labs, or TestingBot services. If your tests are running against a web site hosted on your local computer (localhost), or on a
+staging server inside your LAN, you must set the **TUNNELING** Environment Variable to true.
 
 
 #### Remote desktop browsers on the BrowserStack service
@@ -757,6 +791,13 @@ landscape orientation running on the BrowserStack service:
 
 
 
+## Web Test Automation Framework Implementation
+
+ <img src="http://i.imgur.com/K4XGTQi.jpg" width="1024" alt="Web Framework Overview" title="Web Framework Overview">
+
+
+
+
 ## Copyright and License
 
 TestCentricity™ Framework is Copyright (c) 2014-2016, Tony Mrozinski.

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '0.6.3'
+  VERSION = '0.6.4'
 end

data/testcentricity_web.gemspec

@@ -11,9 +11,9 @@ Gem::Specification.new do |spec|
   spec.authors       = ['A.J. Mrozinski']
   spec.email         = ['test_automation@icloud.com']
   spec.summary       = %q{A Page Object and Data Object Model Framework for desktop and mobile web testing}
-  spec.description = %q{
+  spec.description   = %q{
     TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object Model DSL,
-    for use with Cucumber, Capybara, and selenium-webdriver. Supports testing against locally hosted desktop browsers
+    for use with Cucumber, Capybara, and Selenium-Webdriver. Supports testing against locally hosted desktop browsers
     (Firefox, Chrome, Safari, IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox), a
     "headless" browser (using Poltergeist and PhantomJS), or on cloud hosted browsers using the BrowserStack, Sauce Labs,
     CrossBrowserTesting, or TestingBot services.}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.6.4
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-28 00:00:00.000000000 Z
+date: 2016-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -145,7 +145,7 @@ dependencies:
 description: |2-
 
       TestCentricity™ core generic framework for desktop and mobile web site testing implements a Page Object Model DSL,
-      for use with Cucumber, Capybara, and selenium-webdriver. Supports testing against locally hosted desktop browsers
+      for use with Cucumber, Capybara, and Selenium-Webdriver. Supports testing against locally hosted desktop browsers
       (Firefox, Chrome, Safari, IE, or Edge), locally hosted emulated iOS and Android mobile browsers (using Firefox), a
       "headless" browser (using Poltergeist and PhantomJS), or on cloud hosted browsers using the BrowserStack, Sauce Labs,
       CrossBrowserTesting, or TestingBot services.