testcentricity_web 3.0.7 → 3.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9740d09f5ae251d5d16505b76876418ac8d64dfd
-  data.tar.gz: bfbb4d31516bb66df59855505678317b88938ce8
+  metadata.gz: '09f6bbb5fd6d45a4e0783ce4a2eedcb8d81f58a5'
+  data.tar.gz: 144f6b80f4d26187a4d6890561b6da2af28435b3
 SHA512:
-  metadata.gz: ee417aeb72511576084eb0cd2820c38c1ebc86cfaeeee3c9d275300ec789f885ea8bec537d61f19b666c61e2e48cb6ad41a78df9cd69d7bee1c4706ca4c08b9c
-  data.tar.gz: d6711b2fd8ff0e84963596650a292380b807d0dfd34344cb6e09e5fabbcba9731a9f7a881c24e23811cdb1ebb95cdc8679f71b31d5710836e9c01c196f00423f
+  metadata.gz: bc1cd2e1cafa3546b9d155ede4f3d5143464eb61d6708981c725484d2935252347a3ed59d45c0670691ecfdfda7cae01e454957af88a63cb7c2b5fe4c95751d7
+  data.tar.gz: 47b00fcb5176454ddf83b4e1276802eae6fae3ec773ce1a074198e68369a959bc1b5893a7f52f813ad2288413fcc76ec08f6c73f99c4d274fc10a63a6e128fca

data/.rubocop.yml

@@ -19,9 +19,6 @@ Metrics/ModuleLength:
 Metrics/ClassLength:
   Enabled: false
 
-Encoding:
-  EnforcedStyle: when_needed
-
 Metrics/LineLength:
   Enabled: false
 
@@ -37,5 +34,5 @@ Style/HashSyntax:
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-Style/EmptyLines:
+Layout/EmptyLines:
   Enabled: false

data/HISTORY.md

@@ -1,5 +1,11 @@
 # HISTORY
 
+###Version 3.0.8
+
+* Added `PageObject.wait_for_ajax` method.
+* `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods now accept optional `fail_message` string parameter to add context to error
+messages when UI verifications raise an exception.
+
 ###Version 3.0.7
 
 * Added support for connecting to and running your tests in desktop and emulated mobile web browsers hosted on Selenium Grid and Dockerized Selenium

data/README.md

@@ -26,6 +26,12 @@ The TestCentricity™ Web gem supports running automated tests against the follo
 
 A complete history of bug fixes and new features can be found in the {file:HISTORY.md HISTORY} file.
 
+###Version 3.0.8
+
+* Added `PageObject.wait_for_ajax` method.
+* `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods now accept optional `fail_message` string parameter to add context to error
+messages when UI verifications raise an exception.
+
 ###Version 3.0.7
 
 * Added support for connecting to and running your tests in desktop and emulated mobile web browsers hosted on Selenium Grid and Dockerized Selenium
@@ -1484,6 +1490,7 @@ text with the Subdomain specified on the Grid Configuration Parameters section o
     gl_ie10_win8:       --profile gl_win8 GL_BROWSER="internet explorer" GL_VERSION="10"
     gl_ie11_win10:      --profile gl_win10 GL_BROWSER="internet explorer" GL_VERSION="11"
     
+    # Gridlastic Linux desktop browser profiles
     gl_chrome_linux:    --profile gl_desktop GL_OS="LINUX" GL_BROWSER="chrome" GL_VERSION="latest"
 
 

data/lib/testcentricity_web/exception_queue_helper.rb

@@ -22,8 +22,11 @@ module TestCentricity
       enqueue(error_message)
     end
 
-    def self.post_exceptions
-      raise @error_queue unless @error_queue.nil?
+    def self.post_exceptions(preample_message = nil)
+      unless @error_queue.nil?
+        @error_queue = "#{preample_message} - The following errors were found:\n_______________________________\n#{@error_queue}" unless preample_message.nil?
+        raise @error_queue
+      end
     ensure
       @error_queue = nil
     end

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.0.7'
+  VERSION = '3.0.8'
 end

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -483,7 +483,7 @@ module TestCentricity
     #
     # @param seconds [Integer or Float] wait time in seconds
     # @example
-    #   verifying_page.wait_until_gone(15)
+    #   payment_processing_page.wait_until_gone(15)
     #
     def wait_until_gone(seconds = nil)
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
@@ -493,6 +493,23 @@ module TestCentricity
       raise "Page object #{self.class.name} remained visible after #{timeout} seconds" if exists?
     end
 
+    # Wait until all AJAX requests have completed, or until the specified wait time has expired. If the wait time is nil, then
+    # the wait time will be Capybara.default_max_wait_time.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   shopping_basket_page.wait_for_ajax(15)
+    #
+    def wait_for_ajax(seconds = nil)
+      wait_time = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      Timeout.timeout(wait_time) do
+        loop do
+          active = page.evaluate_script('jQuery.active')
+          break if active == 0
+        end
+      end
+    end
+
     # Is current Page object URL secure?
     #
     # @return [Boolean]
@@ -503,7 +520,7 @@ module TestCentricity
       !current_url.match(/^https/).nil?
     end
 
-    def verify_ui_states(ui_states)
+    def verify_ui_states(ui_states, fail_message = nil)
       ui_states.each do |ui_object, object_states|
         object_states.each do |property, state|
           case property
@@ -607,7 +624,7 @@ module TestCentricity
     rescue ObjectNotFoundError => e
       ExceptionQueue.enqueue_exception(e.message)
     ensure
-      ExceptionQueue.post_exceptions
+      ExceptionQueue.post_exceptions(fail_message)
     end
 
     # Populate the specified UI elements on this page with the associated data from a Hash passed as an argument. Data

data/lib/testcentricity_web/web_core/page_sections_helper.rb

@@ -695,7 +695,7 @@ module TestCentricity
       section.send_keys(*keys)
     end
 
-    def verify_ui_states(ui_states)
+    def verify_ui_states(ui_states, fail_message = nil)
       ui_states.each do |ui_object, object_states|
         object_states.each do |property, state|
           case property
@@ -799,7 +799,7 @@ module TestCentricity
     rescue ObjectNotFoundError => e
       ExceptionQueue.enqueue_exception(e.message)
     ensure
-      ExceptionQueue.post_exceptions
+      ExceptionQueue.post_exceptions(fail_message)
     end
 
     # Populate the specified UI elements in this Section object with the associated data from a Hash passed as an

data/testcentricity_web.gemspec

@@ -31,13 +31,13 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler', '~> 1.5'
   spec.add_development_dependency 'rake'
 
-  spec.add_runtime_dependency 'capybara'
+  spec.add_runtime_dependency 'capybara', '>= 3.1', '< 4'
   spec.add_runtime_dependency 'test-unit'
   spec.add_runtime_dependency 'selenium-webdriver', ['>= 3.11.0', '< 4.0']
   spec.add_runtime_dependency 'faker'
   spec.add_runtime_dependency 'chronic', '0.10.2'
   spec.add_runtime_dependency 'spreadsheet', '1.1.1'
-  spec.add_runtime_dependency 'os'
+  spec.add_runtime_dependency 'os', '~> 1.0'
   spec.add_runtime_dependency 'i18n'
   spec.add_runtime_dependency 'browserstack-local'
   spec.add_runtime_dependency 'appium_lib'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.0.7
+  version: 3.0.8
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-21 00:00:00.000000000 Z
+date: 2018-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -44,14 +44,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -132,16 +138,16 @@ dependencies:
   name: os
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement