testcentricity_web 0.5.4 → 0.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8eac97f61bc406208f747ef3f6b85c0078d41498
-  data.tar.gz: cf07e512e939c2af1ab03a8823e14457393cc678
+  metadata.gz: 3fd47e4f7d10641c98afe707dbe294f97b6038cc
+  data.tar.gz: 0125169d38b9d3f04b919428f0bb478a810bf3ab
 SHA512:
-  metadata.gz: 93d41573d1d76f30c80e691ae2b71168ea54e4a026ef8ed252bd3a66a32e287d8c179dd76dd7b37ca0e04e9ec82b8fb3a5b40bf3371aa7531528a32a8fdf2cd8
-  data.tar.gz: c7967d82b27dc411ace1e3a99f3b1a32677b5f0b1354ed0ef8de3283dcc6bae6487aa2097877cf73cd2c32e516e7a28be6594ac7b829e1b6e34664b4cd728851
+  metadata.gz: 31814f76f6369edf6c82c8c38bd5041ee29c96d4fe758baa0f629311639723833a4d0a1ddbcae9e5203bd0bc0d1dcea7622278bb70acd4b00838a20e05e8d861
+  data.tar.gz: 92ee7504492cf6d61a1038799f629ec31687cbcaf4fd24f13297d43487eaeefdf1964a4be112933f40cfa5a5337b1fe51b7df4992f0883fd84fc67ddd453e65f

data/lib/testcentricity_web/page_objects_helper.rb

@@ -9,7 +9,7 @@ module TestCentricity
 
     # Define a trait for this page object.
     #
-    # @param trait_name [symbol] name of trait (as a symbol)
+    # @param trait_name [Symbol] name of trait (as a symbol)
     # @param block [&block] trait value
     # @example
     #   trait(:page_name)     { 'Shopping Basket' }
@@ -20,9 +20,9 @@ module TestCentricity
       define_method(trait_name.to_s, &block)
     end
 
-    # Define and instantiate a generic UI Element for this page object.
+    # Declare and instantiate a generic UI Element for this page object.
     #
-    # @param element_name [symbol] name of UI object (as a symbol)
+    # @param element_name [Symbol] name of UI object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   element :siebel_view,  'div#_sweview'
@@ -32,9 +32,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, nil);end))
     end
 
-    # Define and instantiate a button UI Element for this page object.
+    # Declare and instantiate a button UI Element for this page object.
     #
-    # @param element_name [symbol] name of button object (as a symbol)
+    # @param element_name [Symbol] name of button object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   button :checkout_button, "button.checkout_button"
@@ -44,9 +44,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :button);end))
     end
 
-    # Define and instantiate a text field UI Element for this page object.
+    # Declare and instantiate a text field UI Element for this page object.
     #
-    # @param element_name [symbol] name of text field object (as a symbol)
+    # @param element_name [Symbol] name of text field object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   textfield :user_id_field,  "//input[@id='UserName']"
@@ -56,9 +56,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :textfield);end))
     end
 
-    # Define and instantiate a checkbox UI Element for this page object.
+    # Declare and instantiate a checkbox UI Element for this page object.
     #
-    # @param element_name [symbol] name of checkbox object (as a symbol)
+    # @param element_name [Symbol] name of checkbox object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   checkbox :remember_checkbox,     "//input[@id='RememberUser']"
@@ -68,9 +68,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :checkbox);end))
     end
 
-    # Define and instantiate a label UI Element for this page object.
+    # Declare and instantiate a label UI Element for this page object.
     #
-    # @param element_name [symbol] name of label object (as a symbol)
+    # @param element_name [Symbol] name of label object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   label :welcome_label,      'div.Welcome'
@@ -80,9 +80,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :label);end))
     end
 
-    # Define and instantiate a link UI Element for this page object.
+    # Declare and instantiate a link UI Element for this page object.
     #
-    # @param element_name [symbol] name of link object (as a symbol)
+    # @param element_name [Symbol] name of link object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   link :registration_link,    "a.account-nav__link.register"
@@ -92,9 +92,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :link);end))
     end
 
-    # Define and instantiate a table UI Element for this page object.
+    # Declare and instantiate a table UI Element for this page object.
     #
-    # @param element_name [symbol] name of table object (as a symbol)
+    # @param element_name [Symbol] name of table object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   table :payments_table, "//table[@class='payments_table']"
@@ -103,9 +103,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :table);end))
     end
 
-    # Define and instantiate a select list UI Element for this page object.
+    # Declare and instantiate a select list UI Element for this page object.
     #
-    # @param element_name [symbol] name of select list object (as a symbol)
+    # @param element_name [Symbol] name of select list object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   selectlist :category_selector, "search_form_category_chosen"
@@ -115,9 +115,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :selectlist);end))
     end
 
-    # Define and instantiate an image UI Element for this page object.
+    # Declare and instantiate an image UI Element for this page object.
     #
-    # @param element_name [symbol] name of image object (as a symbol)
+    # @param element_name [Symbol] name of image object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   image :basket_item_image,    "div.product_image"
@@ -127,6 +127,13 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page, :image);end))
     end
 
+    # Instantiate a PageSection object for this page object.
+    #
+    # @param section_name [Symbol] name of PageSection object (as a symbol)
+    # @param class_name [String] Class name of PageSection object
+    # @example
+    #   section :search_form, SearchForm
+    #
     def self.section(section_name, class_name, locator = nil)
       class_eval(%Q(def #{section_name.to_s};@#{section_name.to_s} ||= #{class_name.to_s}.new(self, "#{locator}", :page);end))
     end

data/lib/testcentricity_web/page_sections_helper.rb

@@ -18,7 +18,7 @@ module TestCentricity
 
     # Define a trait for this page section.
     #
-    # @param trait_name [symbol] name of trait (as a symbol)
+    # @param trait_name [Symbol] name of trait (as a symbol)
     # @param block [&block] trait value
     # @example
     #   trait(:section_locator)  { "//div[@class='Messaging_Applet']" }
@@ -28,9 +28,9 @@ module TestCentricity
       define_method(trait_name.to_s, &block)
     end
 
-    # Define and instantiate a generic UI Element for this page section.
+    # Declare and instantiate a generic UI Element for this page section.
     #
-    # @param element_name [symbol] name of UI object (as a symbol)
+    # @param element_name [Symbol] name of UI object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   element :undo_record_item,  "//li[@rn='Undo Record']/a"
@@ -40,9 +40,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, nil);end))
     end
 
-    # Define and instantiate a button UI Element for this page section.
+    # Declare and instantiate a button UI Element for this page section.
     #
-    # @param element_name [symbol] name of button object (as a symbol)
+    # @param element_name [Symbol] name of button object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   button :checkout_button, "button.checkout_button"
@@ -52,9 +52,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :button);end))
     end
 
-    # Define and instantiate a text field UI Element for this page section.
+    # Declare and instantiate a text field UI Element for this page section.
     #
-    # @param element_name [symbol] name of text field object (as a symbol)
+    # @param element_name [Symbol] name of text field object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   textfield :user_id_field,  "//input[@id='UserName']"
@@ -64,9 +64,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :textfield);end))
     end
 
-    # Define and instantiate a checkbox UI Element for this page section.
+    # Declare and instantiate a checkbox UI Element for this page section.
     #
-    # @param element_name [symbol] name of checkbox object (as a symbol)
+    # @param element_name [Symbol] name of checkbox object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   checkbox :remember_checkbox,     "//input[@id='RememberUser']"
@@ -76,9 +76,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :checkbox);end))
     end
 
-    # Define and instantiate a label UI Element for this page section.
+    # Declare and instantiate a label UI Element for this page section.
     #
-    # @param element_name [symbol] name of label object (as a symbol)
+    # @param element_name [Symbol] name of label object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   label :welcome_label,      'div.Welcome'
@@ -88,9 +88,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :label);end))
     end
 
-    # Define and instantiate a link UI Element for this page section.
+    # Declare and instantiate a link UI Element for this page section.
     #
-    # @param element_name [symbol] name of link object (as a symbol)
+    # @param element_name [Symbol] name of link object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   link :registration_link,    "a.account-nav__link.register"
@@ -100,9 +100,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :link);end))
     end
 
-    # Define and instantiate a table UI Element for this page section.
+    # Declare and instantiate a table UI Element for this page section.
     #
-    # @param element_name [symbol] name of table object (as a symbol)
+    # @param element_name [Symbol] name of table object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   table :payments_table, "//table[@class='payments_table']"
@@ -111,9 +111,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :table);end))
     end
 
-    # Define and instantiate a select list UI Element for this page section.
+    # Declare and instantiate a select list UI Element for this page section.
     #
-    # @param element_name [symbol] name of select list object (as a symbol)
+    # @param element_name [Symbol] name of select list object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   selectlist :category_selector, "search_form_category_chosen"
@@ -123,9 +123,9 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :selectlist);end))
     end
 
-    # Define and instantiate an image UI Element for this page section.
+    # Declare and instantiate an image UI Element for this page section.
     #
-    # @param element_name [symbol] name of image object (as a symbol)
+    # @param element_name [Symbol] name of image object (as a symbol)
     # @param locator [String] css selector or xpath expression that uniquely identifies object
     # @example
     #   image :basket_item_image,    "div.product_image"
@@ -135,6 +135,13 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section, :image);end))
     end
 
+    # Instantiate a PageSection object within this PageSection object.
+    #
+    # @param section_name [Symbol] name of PageSection object (as a symbol)
+    # @param class_name [String] Class name of PageSection object
+    # @example
+    #   section :search_form, SearchForm
+    #
     def self.section(section_name, class_name, locator = nil)
       class_eval(%Q(def #{section_name.to_s};@#{section_name.to_s} ||= #{class_name.to_s}.new(self, "#{locator}", :section);end))
     end
@@ -197,7 +204,7 @@ module TestCentricity
 
     # Wait until the Section object exists, or until the specified wait time has expired.
     #
-    # @param seconds [Integer, Float] wait time in seconds
+    # @param seconds [Integer or Float] wait time in seconds
     # @example
     #   navigation_toolbar.wait_until_exists(0.5)
     #
@@ -211,7 +218,7 @@ module TestCentricity
 
     # Wait until the Section object no longer exists, or until the specified wait time has expired.
     #
-    # @param seconds [Integer, Float] wait time in seconds
+    # @param seconds [Integer or Float] wait time in seconds
     # @example
     #   navigation_toolbar.wait_until_gone(5)
     #

data/lib/testcentricity_web/ui_elements_helper.rb

@@ -225,7 +225,7 @@ module TestCentricity
 
     # Wait until the object exists, or until the specified wait time has expired.
     #
-    # @param seconds [Integer, Float] wait time in seconds
+    # @param seconds [Integer or Float] wait time in seconds
     # @example
     #   run_button.wait_until_exists(0.5)
     #
@@ -239,7 +239,7 @@ module TestCentricity
 
     # Wait until the object no longer exists, or until the specified wait time has expired.
     #
-    # @param seconds [Integer, Float] wait time in seconds
+    # @param seconds [Integer or Float] wait time in seconds
     # @example
     #   logout_button.wait_until_gone(5)
     #
@@ -253,7 +253,7 @@ module TestCentricity
 
     # Wait until the object's value equals the specified value, or until the specified wait time has expired.
     #
-    # @param seconds [Integer, Float] wait time in seconds
+    # @param seconds [Integer or Float] wait time in seconds
     # @example
     #   card_authorized_label.wait_until_value_is(5, 'Card authorized')
     #
@@ -267,7 +267,7 @@ module TestCentricity
 
     # Wait until the object's value changes to a different value, or until the specified wait time has expired.
     #
-    # @param seconds [Integer, Float] wait time in seconds
+    # @param seconds [Integer or Float] wait time in seconds
     # @example
     #   basket_grand_total_label.wait_until_value_changes(5)
     #

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '0.5.4'
+  VERSION = '0.5.5'
 end

data/lib/testcentricity_web/webdriver_helper.rb

@@ -2,7 +2,7 @@ module TestCentricity
   class WebDriverConnect
     include Capybara::DSL
 
-    def self.initialize_web_driver(environment)
+    def self.initialize_web_driver(app_host)
       browser = ENV['WEB_BROWSER']
 
       # assume that we're testing within a local desktop web browser
@@ -22,9 +22,7 @@ module TestCentricity
           initialize_local_browser(browser)
       end
 
-      (environment.hostname.length > 0) ?
-          Capybara.app_host = "#{environment.protocol}://#{environment.hostname}/#{environment.base_url}" :
-          Capybara.app_host = "#{environment.protocol}://#{environment.base_url}"
+      Capybara.app_host = app_host
 
       # set browser window size only if testing with a desktop web browser
       if Environ.is_desktop?

data/lib/testcentricity_web/world_extensions.rb

@@ -0,0 +1,26 @@
+module WorldData
+  def environs
+    @environs ||= TestCentricity::EnvironData.new
+  end
+
+  def instantiate_data_objects
+    return if TestCentricity::DataManager.loaded?
+
+    data_objects.each do | data_type, data_class |
+      eval("def #{data_type.to_s};@#{data_type.to_s} ||= #{data_class}.new;end")
+      TestCentricity::DataManager.register_data_object(data_type, data_class.new)
+    end
+  end
+end
+
+
+module WorldPages
+  def instantiate_page_objects
+    return if TestCentricity::PageManager.loaded?
+
+    page_objects.each do | page_object, page_class |
+      eval("def #{page_object.to_s};@#{page_object.to_s} ||= #{page_class}.new;end")
+      TestCentricity::PageManager.register_page_object(page_object, page_class.new)
+    end
+  end
+end

data/lib/testcentricity_web.rb

@@ -1,6 +1,7 @@
 require 'capybara/cucumber'
 require 'rspec/expectations'
 require 'test/unit'
+require 'testcentricity_web/world_extensions'
 require 'testcentricity_web/browser_helper'
 require 'testcentricity_web/data_objects_helper'
 require 'testcentricity_web/drag_drop_helper'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 0.5.4
+  version: 0.5.5
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-16 00:00:00.000000000 Z
+date: 2016-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -194,6 +194,7 @@ files:
 - lib/testcentricity_web/utility_helpers.rb
 - lib/testcentricity_web/version.rb
 - lib/testcentricity_web/webdriver_helper.rb
+- lib/testcentricity_web/world_extensions.rb
 - testcentricity_web.gemspec
 homepage: ''
 licenses: