testcentricity_web 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: acada2c571dec453cbec4de28d0607efc44e267e
-  data.tar.gz: 49a1f4ae2be03a57ed4d833b100c956fb5aaa493
+  metadata.gz: 2f494b9af6b3241d6335a6f393c9b7d0e11c7243
+  data.tar.gz: e662186ea64b03aee0b5ec7d03dce83dcbac38f9
 SHA512:
-  metadata.gz: 9e6a07b4c065fce75e4cad743db595fef512d9fb34ff4e7bce6cc9ac18fd19266b871042bd43054787e0f06efc5f83ea219b5d357d1fd6a4fb2160113145372a
-  data.tar.gz: a8dd9f0535d3a02ce200de98a6bee4a56d465f3d294b7f0c1935503b1f990b44da05d4fc116094133f92ca4fdf9dfd51992ac360a595a3e3dc8fb0c285f66e7c
+  metadata.gz: 58740657c8799577dc74e5aa9b642a35481e299d3d4f029e50a08bfb6d4397964ba7a78d4ed2703532f3022763542fcd6b17f091c36ad3538cf76df4769ac63f
+  data.tar.gz: d50fa04094bdcd160314e6c408540b9deecdf8552cc32d6d37449e034543b1fcd24b6085058ee489616ead22b3155d648cf77d0df66adc723340e9f785279abe

data/README.md

@@ -164,6 +164,30 @@ You define your page's **Traits** as shown below:
       label     :error_message_label, 'div#statusBar.login-error'
     end
     
+
+    class RegistrationPage < TestCentricity::PageObject
+      trait(:page_name)       { 'Registration' }
+      trait(:page_url)        { '/register' }
+      trait(:page_locator)    { 'body.registration' }
+     
+      # Registration page UI elements
+      textfields  first_name_field:    'input#firstName',
+                  last_name_field:     'input#lastName',
+                  email_field:         'input#email',
+                  phone_number_field:  'input#phone',
+                  address_field:       'input#streetAddress',
+                  city_field:          'input#city',
+                  post_code_field:     'input#postalCode',
+                  password_field:      'input#password',
+                  pword_confirm_field: 'input#passwordConfirmation'
+      selectlists title_select:        'select#title',
+                  gender_select:       'select#gender',
+                  state_select:        'select#stateProvince'
+      checkbox    :email_opt_in_check, 'input#marketingEmailsOptIn'
+      button      :sign_up_button,     'button#registrationSignUp'
+    end
+
+    
 Once your **Page Objects** have been instantiated, you can interact with the **UI Elements** in your **Page Objects**. An example is shown
 below:
 
@@ -214,6 +238,48 @@ the UI to hide implementation details, as shown below:
         super
       end
     end
+        
+
+    class RegistrationPage < TestCentricity::PageObject
+      trait(:page_name)       { 'Registration' }
+      trait(:page_url)        { '/register' }
+      trait(:page_locator)    { 'body.registration' }
+     
+      # Registration page UI elements
+      textfields  first_name_field:    'input#firstName',
+                  last_name_field:     'input#lastName',
+                  email_field:         'input#email',
+                  phone_number_field:  'input#phone',
+                  address_field:       'input#streetAddress',
+                  city_field:          'input#city',
+                  post_code_field:     'input#postalCode',
+                  password_field:      'input#password',
+                  pword_confirm_field: 'input#passwordConfirmation'
+      selectlists title_select:        'select#title',
+                  gender_select:       'select#gender',
+                  state_select:        'select#stateProvince'
+      checkbox    :email_opt_in_check, 'input#marketingEmailsOptIn'
+      button      :sign_up_button,     'button#registrationSignUp'
+      
+      def enter_profile_data(profile)
+        fields = { title_select        => profile.title,
+                   first_name_field    => profile.first_name,
+                   last_name_field     => profile.last_name,
+                   gender_select       => profile.gender,
+                   phone_number_field  => profile.phone,
+                   email_field         => profile.email,
+                   address_field       => profile.address,
+                   city_field          => profile.city,
+                   state_select        => profile.state,
+                   post_code_field     => profile.postal_code,
+                   password_field      => profile.password,
+                   pword_confirm_field => profile.confirm_password
+          }
+        populate_data_fields(fields)
+        sign_up_button.click
+      end
+    end
+
 
 
 Once your **Page Objects** have been instantiated, you can call your methods as shown below:
@@ -394,7 +460,7 @@ Include the step definitions and code below in a `page_steps.rb` or `generic_ste
 
     include TestCentricity
     
-    Given(/^I am (?:on|viewing) the ([^\"]*) page$/) do |page_name|
+    Given(/^I am on the ([^\"]*) page$/) do |page_name|
       target_page = page_dispatcher(page_name)
       target_page.load_page if target_page
       PageManager.set_current_page(target_page)
@@ -421,7 +487,7 @@ Include the step definitions and code below in a `page_steps.rb` or `generic_ste
     end
     
     
-    # this method that takes a page name as a parameter and returns an instance of the associated Page Object
+    # 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

data/lib/testcentricity_web/elements/file_field.rb

@@ -13,5 +13,19 @@ module TestCentricity
       page.attach_file(@locator, file_path)
       Capybara.ignore_hidden_elements = true
     end
+
+    def drop_files(files)
+      js_script = "fileList = Array();"
+      files.count.times do |i|
+        # generate a fake input selector
+        page.execute_script("if ($('#seleniumUpload#{i}').length == 0) { seleniumUpload#{i} = window.$('<input/>').attr({id: 'seleniumUpload#{i}', type:'file'}).appendTo('body'); }")
+        # attach file to the fake input selector through Capybara
+        attach_file("seleniumUpload#{i}", files[i])
+        # create the fake js event
+        js_script = "#{js_script} fileList.push(seleniumUpload#{i}.get(0).files[0]);"
+      end
+      # trigger the fake drop event
+      page.execute_script("#{js_script} e = $.Event('drop'); e.originalEvent = {dataTransfer : { files : fileList } }; $('##{@locator}').trigger(e);")
+    end
   end
 end

data/lib/testcentricity_web/page_objects_helper.rb

@@ -112,6 +112,15 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::CheckBox.new(self, "#{locator}", :page, #{proxy});end))
     end
 
+    # Declare and instantiate a collection of checkboxes for this page object.
+    #
+    # @param element_hash [Hash] names of checkboxes (as a symbol) and CSS selectors or XPath expressions that uniquely identifies checkboxes
+    # @example
+    #       checkboxes  hazmat_certified_check:  'input#hazmatCertified',
+    #                   epa_certified_check:     'input#epaCertified',
+    #                   dhs_certified_check:     'input#homelandSecurityCertified',
+    #                   carb_compliant_check:    'input#carbCompliant'
+    #
     def self.checkboxes(element_hash)
       element_hash.each do |element_name, locator|
         checkbox(element_name, locator)
@@ -131,6 +140,15 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Radio.new(self, "#{locator}", :page, #{proxy});end))
     end
 
+    # Declare and instantiate a collection of radio buttons for this page object.
+    #
+    # @param element_hash [Hash] names of radio buttons (as a symbol) and CSS selectors or XPath expressions that uniquely identifies radio buttons
+    # @example
+    #       radios  visa_radio:       'input#payWithVisa',
+    #               mastercard_radio: 'input#payWithMastercard',
+    #               discover_radio:   'input#payWithDiscover',
+    #               amex_radio:       'input#payWithAmEx'
+    #
     def self.radios(element_hash)
       element_hash.each do |element_name, locator|
         radio(element_name, locator)

data/lib/testcentricity_web/page_sections_helper.rb

@@ -39,6 +39,14 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section);end))
     end
 
+    # Declare and instantiate a collection of generic UI Elements for this page section.
+    #
+    # @param element_hash [Hash] names of UI objects (as a symbol) and CSS selectors or XPath expressions that uniquely identifies objects
+    # @example
+    #   elements  profile_item:  'a#profile',
+    #             settings_item: 'a#userPreferencesTrigger',
+    #             log_out_item:  'a#logout'
+    #
     def self.elements(element_hash)
       element_hash.each do |element_name, locator|
         element(element_name, locator)
@@ -57,6 +65,14 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Button.new(self, "#{locator}", :section);end))
     end
 
+    # Declare and instantiate a collection of buttons for this page section.
+    #
+    # @param element_hash [Hash] names of buttons (as a symbol) and CSS selectors or XPath expressions that uniquely identifies buttons
+    # @example
+    #     buttons new_account_button:  'button#new-account',
+    #             save_button:         'button#save',
+    #             cancel_button:       'button#cancel'
+    #
     def self.buttons(element_hash)
       element_hash.each do |element_name, locator|
         button(element_name, locator)
@@ -75,6 +91,16 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::TextField.new(self, "#{locator}", :section);end))
     end
 
+    # Declare and instantiate a collection of text fields for this page section.
+    #
+    # @param element_hash [Hash] names of text fields (as a symbol) and CSS selectors or XPath expressions that uniquely identifies text fields
+    # @example
+    #       textfields  name_field:    'input#Name',
+    #                   title_field:   'input#Title',
+    #                   phone_field:   'input#PhoneNumber',
+    #                   fax_field:     'input#FaxNumber',
+    #                   email_field:   'input#Email'
+    #
     def self.textfields(element_hash)
       element_hash.each do |element_name, locator|
         textfield(element_name, locator)
@@ -94,6 +120,15 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::CheckBox.new(self, "#{locator}", :section, #{proxy});end))
     end
 
+    # Declare and instantiate a collection of checkboxes for this page section.
+    #
+    # @param element_hash [Hash] names of checkboxes (as a symbol) and CSS selectors or XPath expressions that uniquely identifies checkboxes
+    # @example
+    #       checkboxes  hazmat_certified_check:  'input#hazmatCertified',
+    #                   epa_certified_check:     'input#epaCertified',
+    #                   dhs_certified_check:     'input#homelandSecurityCertified',
+    #                   carb_compliant_check:    'input#carbCompliant'
+    #
     def self.checkboxes(element_hash)
       element_hash.each do |element_name, locator|
         checkbox(element_name, locator)
@@ -113,6 +148,15 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Radio.new(self, "#{locator}", :section, #{proxy});end))
     end
 
+    # Declare and instantiate a collection of radio buttons for this page section.
+    #
+    # @param element_hash [Hash] names of radio buttons (as a symbol) and CSS selectors or XPath expressions that uniquely identifies radio buttons
+    # @example
+    #       radios  visa_radio:       'input#payWithVisa',
+    #               mastercard_radio: 'input#payWithMastercard',
+    #               discover_radio:   'input#payWithDiscover',
+    #               amex_radio:       'input#payWithAmEx'
+    #
     def self.radios(element_hash)
       element_hash.each do |element_name, locator|
         radio(element_name, locator)
@@ -348,6 +392,34 @@ module TestCentricity
       raise "Section #{get_locator} remained visible after #{timeout} seconds" if exists?
     end
 
+    # Wait until the Section object is visible, or until the specified wait time has expired.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   bar_chart_section.wait_until_visible(0.5)
+    #
+    def wait_until_visible(seconds = nil)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { visible? }
+    rescue
+      raise "Could not find section #{get_locator} after #{timeout} seconds" unless visible?
+    end
+
+    # Wait until the Section object is hidden, or until the specified wait time has expired.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   bar_chart_section.wait_until_hidden(10)
+    #
+    def wait_until_hidden(seconds = nil)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { hidden? }
+    rescue
+      raise "section #{get_locator} remained visible after #{timeout} seconds" if visible?
+    end
+
     # Click at a specific location within a Section object
     #
     # @param x [Integer] X offset

data/lib/testcentricity_web/ui_elements_helper.rb

@@ -208,6 +208,20 @@ module TestCentricity
       raise "Could not find element #{@locator} after #{timeout} seconds" unless exists?
     end
 
+    # Wait until the object no longer exists, or until the specified wait time has expired.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   logout_button.wait_until_gone(5)
+    #
+    def wait_until_gone(seconds = nil)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { !exists? }
+    rescue
+      raise "Element #{@locator} remained visible after #{timeout} seconds" if exists?
+    end
+
     # Wait until the object is visible, or until the specified wait time has expired.
     #
     # @param seconds [Integer or Float] wait time in seconds
@@ -219,21 +233,21 @@ module TestCentricity
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { visible? }
     rescue
-      raise "Could not find element #{@locator} after #{timeout} seconds" unless exists?
+      raise "Could not find element #{@locator} after #{timeout} seconds" unless visible?
     end
 
-    # Wait until the object no longer exists, or until the specified wait time has expired.
+    # Wait until the object is hidden, or until the specified wait time has expired.
     #
     # @param seconds [Integer or Float] wait time in seconds
     # @example
-    #   logout_button.wait_until_gone(5)
+    #   run_button.wait_until_hidden(10)
     #
-    def wait_until_gone(seconds = nil)
+    def wait_until_hidden(seconds = nil)
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
-      wait.until { !exists? }
+      wait.until { hidden? }
     rescue
-      raise "Element #{@locator} remained visible after #{timeout} seconds" if exists?
+      raise "Element #{@locator} remained visible after #{timeout} seconds" if visible?
     end
 
     # Wait until the object's value equals the specified value, or until the specified wait time has expired.

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '1.0.5'
+  VERSION = '1.0.6'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-25 00:00:00.000000000 Z
+date: 2016-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler