testcentricity_web 3.2.20 → 3.2.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06df79fffc76a0f986855b9df2da06a9f4e894625fe6863f2502eddc6002c723
-  data.tar.gz: 0ceace5caaf65a8e87f56ef064c6e2b2d8ca8af11ec6dc8a96151aa8488d254c
+  metadata.gz: 49868a5ac9a36308a250e4682750a7450c94f0bd297d8103d25170fbd067491e
+  data.tar.gz: bd80b70984d2646cf6d510be7517d9a2e5d353df69c30f367c89bfba7d29e011
 SHA512:
-  metadata.gz: 8a054bb3d399e07ecde209201e519bf3084245d21f56f071ab5e3f903ed66fe4e395c39995a504799ae8b0285fa8d44ac90516f518d3183c0aee67416e344caa
-  data.tar.gz: a38820009129e8d7951114fedeb380ed881096a06722a8f909c47aa5e9e0189fdb4af086928a143145b7a7aa6e6e63344937d1f93c07147eb242a89e64f00684
+  metadata.gz: bb6029661e87b7528125a06dce284b149f09f538c31c24a2835c55f36b7f38a2699c7cd8c9b4768205496b409a2d7b7210ce5e99bdb5a7173c2677343af3def7
+  data.tar.gz: 384e430102526d15a43c35e2bcab9ff11df24497cb342767aacd4527694e06c1053d20ceb69d298841499932aefbca3945d528dfb10871a6b7e70e3268cf415b

data/CHANGELOG.md

@@ -1,6 +1,37 @@
 # CHANGELOG
 All notable changes to this project will be documented in this file.
 
+
+## [3.2.25] - 11-MAR-2021
+
+### Added
+* Added `String.titlecase` method.
+
+## [3.2.23] - 11-FEB-2021
+
+### Changed
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to allow `:translate_upcase`,
+  `:translate_downcase`, `:translate_capitalize`, and `:translate_titlecase` conversions to fall back to `:en` default
+  locale if translated strings are missing from the current locale specified in `I18n.locale`.
+
+## [3.2.22] - 09-FEB-2021
+
+### Fixed
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to correctly handle `:translate_upcase`,
+  `:translate_downcase`, `:translate_capitalize`, and `:translate_titlecase` conversions for Arrays of `String`.
+  
+## [3.2.21] - 04-FEB-2021
+
+### Changed
+* `UIElement.hover_at` method now accepts an optional `visible` parameter to allow hovering over UI elements that are not
+  visible.
+
+## [3.2.20] - 21-JAN-2021
+
+### Changed
+* `UIElement.hover` method now accepts an optional `visible` parameter to allow hovering over UI elements that are not
+visible.
+
 ## [3.2.19] - 05-JAN-2021
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (3.2.19)
+    testcentricity_web (3.2.25)
       appium_lib
       browserstack-local
       capybara (>= 3.1, < 4)
@@ -21,58 +21,60 @@ GEM
   specs:
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
-    appium_lib (10.6.0)
-      appium_lib_core (~> 3.3)
+    appium_lib (11.2.0)
+      appium_lib_core (~> 4.1)
       nokogiri (~> 1.8, >= 1.8.1)
       tomlrb (~> 1.1)
-    appium_lib_core (3.10.0)
-      faye-websocket (~> 0.10.0)
+    appium_lib_core (4.4.1)
+      faye-websocket (~> 0.11.0)
       selenium-webdriver (~> 3.14, >= 3.14.1)
     axiom-types (0.1.1)
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
     browserstack-local (1.3.0)
-    capybara (3.32.2)
+    capybara (3.35.3)
       addressable
       mini_mime (>= 0.1.3)
       nokogiri (~> 1.8)
       rack (>= 1.6.0)
       rack-test (>= 0.6.3)
-      regexp_parser (~> 1.5)
+      regexp_parser (>= 1.5, < 3.0)
       xpath (~> 3.2)
     childprocess (0.9.0)
       ffi (~> 1.0, >= 1.0.11)
     chronic (0.10.2)
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
-    concurrent-ruby (1.1.6)
+    concurrent-ruby (1.1.8)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
     equalizer (0.0.11)
     eventmachine (1.2.7)
-    faker (2.12.0)
+    faker (2.16.0)
       i18n (>= 1.6, < 2)
-    faye-websocket (0.10.9)
+    faye-websocket (0.11.0)
       eventmachine (>= 0.12.0)
       websocket-driver (>= 0.5.1)
-    ffi (1.13.1)
-    i18n (1.8.3)
+    ffi (1.15.0)
+    i18n (1.8.9)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
     mini_mime (1.0.2)
-    mini_portile2 (2.4.0)
-    nokogiri (1.10.9)
-      mini_portile2 (~> 2.4.0)
-    os (1.1.0)
-    power_assert (1.2.0)
-    public_suffix (4.0.5)
+    mini_portile2 (2.5.0)
+    nokogiri (1.11.2)
+      mini_portile2 (~> 2.5.0)
+      racc (~> 1.4)
+    os (1.1.1)
+    power_assert (2.0.0)
+    public_suffix (4.0.6)
+    racc (1.5.2)
     rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
     rake (13.0.1)
     redcarpet (3.5.0)
-    regexp_parser (1.7.1)
+    regexp_parser (2.1.1)
     ruby-ole (1.2.12.2)
     rubyzip (2.3.0)
     selenium-webdriver (3.142.7)
@@ -80,7 +82,7 @@ GEM
       rubyzip (>= 1.2.2)
     spreadsheet (1.1.7)
       ruby-ole (>= 1.0)
-    test-unit (3.3.6)
+    test-unit (3.4.0)
       power_assert
     thread_safe (0.3.6)
     tomlrb (1.3.0)
@@ -89,11 +91,11 @@ GEM
       coercible (~> 1.0)
       descendants_tracker (~> 0.0, >= 0.0.3)
       equalizer (~> 0.0, >= 0.0.9)
-    webdrivers (4.4.1)
+    webdrivers (4.6.0)
       nokogiri (~> 1.6)
       rubyzip (>= 1.3.0)
       selenium-webdriver (>= 3.0, < 4.0)
-    websocket-driver (0.7.2)
+    websocket-driver (0.7.3)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
     xpath (3.2.0)

data/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2020, Tony Mrozinski
+Copyright (c) 2014-2021, Tony Mrozinski
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -1673,7 +1673,7 @@ landscape orientation running on the BrowserStack service:
 
 ## Copyright and License
 
-TestCentricity™ Framework is Copyright (c) 2014-2020, Tony Mrozinski.
+TestCentricity™ Framework is Copyright (c) 2014-2021, Tony Mrozinski.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/lib/testcentricity_web/data_objects/environment.rb

@@ -36,11 +36,14 @@ module TestCentricity
     attr_accessor :device_name
     attr_accessor :device_type
     attr_accessor :device_os
+    attr_accessor :device_os_version
     attr_accessor :device_orientation
     attr_accessor :platform
     attr_accessor :driver
     attr_accessor :grid
     attr_accessor :tunneling
+    attr_accessor :locale
+    attr_accessor :language
 
     attr_accessor :parallel
     attr_accessor :process_num
@@ -58,8 +61,12 @@ module TestCentricity
     attr_accessor :user_id
     attr_accessor :password
     attr_accessor :append
+    attr_accessor :app_id
+    attr_accessor :api_key
     attr_accessor :option1
     attr_accessor :option2
+    attr_accessor :option3
+    attr_accessor :option4
     attr_accessor :dns
     attr_accessor :db_username
     attr_accessor :db_password
@@ -71,12 +78,18 @@ module TestCentricity
       @user_id	     = data['USER_ID']
       @password	     = data['PASSWORD']
       @append	       = data['APPEND']
+      @app_id 	     = data['APP_ID']
+      @api_key	     = data['API_KEY']
       @option1	     = data['OPTIONAL_1']
       @option2	     = data['OPTIONAL_2']
+      @option3	     = data['OPTIONAL_3']
+      @option4	     = data['OPTIONAL_4']
       @dns	         = data['DNS']
       @db_username   = data['DB_USERNAME']
       @db_password   = data['DB_PASSWORD']
       @a11y_standard = ENV['ACCESSIBILITY_STANDARD'] || 'best-practice'
+      @locale        = ENV['LOCALE'] || 'en'
+      @language      = ENV['LANGUAGE'] || 'English'
 
       super
     end
@@ -205,6 +218,14 @@ module TestCentricity
       @device_os
     end
 
+    def self.device_os_version=(version)
+      @device_os_version = version
+    end
+
+    def self.device_os_version
+      @device_os_version
+    end
+
     def self.is_ios?
       @device_os == :ios
     end
@@ -245,6 +266,22 @@ module TestCentricity
       @tunneling
     end
 
+    def self.language=(language)
+      @language = language
+    end
+
+    def self.language
+      @language
+    end
+
+    def self.locale=(locale)
+      @locale = locale
+    end
+
+    def self.locale
+      @locale
+    end
+
     def self.platform=(platform)
       @platform = platform
     end
@@ -305,13 +342,13 @@ module TestCentricity
       report_header = "\n<b><u>TEST ENVIRONMENT</u>:</b> #{ENV['TEST_ENVIRONMENT']}\n"\
       "  <b>Browser:</b>\t #{Environ.browser.capitalize}\n"
       report_header = "#{report_header}  <b>Device:</b>\t\t #{Environ.device_name}\n" if Environ.device_name
-      report_header = "#{report_header}  <b>Device OS:</b>\t #{Environ.device_os}\n" if Environ.device_os
+      report_header = "#{report_header}  <b>Device OS:</b>\t #{Environ.device_os} #{Environ.device_os_version}\n" if Environ.device_os
       report_header = "#{report_header}  <b>Device type:</b>\t #{Environ.device_type}\n" if Environ.device_type
       report_header = "#{report_header}  <b>Driver:</b>\t\t #{Environ.driver}\n" if Environ.driver
       report_header = "#{report_header}  <b>Grid:</b>\t\t #{Environ.grid}\n" if Environ.grid
       report_header = "#{report_header}  <b>OS:</b>\t\t\t #{Environ.os}\n" if Environ.os
-      report_header = "#{report_header}  <b>Locale:</b>\t\t #{ENV['LOCALE']}\n" if ENV['LOCALE']
-      report_header = "#{report_header}  <b>Language:</b>\t #{ENV['LANGUAGE']}\n" if ENV['LANGUAGE']
+      report_header = "#{report_header}  <b>Locale:</b>\t\t #{Environ.locale}\n" if Environ.locale
+      report_header = "#{report_header}  <b>Language:</b>\t #{Environ.language}\n" if Environ.language
       report_header = "#{report_header}  <b>Country:</b>\t #{ENV['COUNTRY']}\n" if ENV['COUNTRY']
       report_header = "#{report_header}  <b>WCAG Accessibility Standard:</b>\t #{ENV['ACCESSIBILITY_STANDARD']}\n" if ENV['ACCESSIBILITY_STANDARD']
       "#{report_header}\n\n"

data/lib/testcentricity_web/exception_queue_helper.rb

@@ -76,20 +76,31 @@ module TestCentricity
             expected    = expected.downcase
             enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
           when :translate
-            expected = I18n.t(value)
+            expected = translate(value)
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_upcase
-            expected = I18n.t(value).upcase
+            expected = translate(value)
+            expected = expected.is_a?(Array) ? expected.map(&:upcase) : expected.upcase
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_downcase
-            expected = I18n.t(value).downcase
+            expected = translate(value)
+            expected = expected.is_a?(Array) ? expected.map(&:downcase) : expected.downcase
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_capitalize
-            expected = I18n.t(value).capitalize
+            expected = translate(value)
+            expected = expected.is_a?(Array) ? expected.map(&:capitalize) : expected.capitalize
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_titlecase
-            expected = I18n.t(value)
-            expected = "#{expected.split.each{ |expected| expected.capitalize! }.join(' ')}"
+            expected = translate(value)
+            expected = if expected.is_a?(Array)
+                         result = []
+                         expected.each do |item|
+                           result.push("#{item.split.each{ |item| item.capitalize! }.join(' ')}")
+                         end
+                         result
+                       else
+                         "#{expected.split.each{ |expected| expected.capitalize! }.join(' ')}"
+                       end
             enqueue_assert_equal(expected, actual, error_msg)
           end
         end
@@ -126,6 +137,29 @@ module TestCentricity
       screen_shot = {path: path, filename: filename}
       Environ.save_screen_shot(screen_shot)
     end
+
+    def self.translate(*args, **opts)
+      opts[:locale] ||= I18n.locale
+      opts[:raise] = true
+      I18n.translate(*args, **opts)
+    rescue I18n::MissingTranslationData => err
+      puts err
+      opts[:locale] = :en
+
+      # fallback to en if the translation is missing. If the translation isn't
+      # in en, then raise again.
+      disable_enforce_available_locales do
+        I18n.translate(*args, **opts)
+      end
+    end
+
+    def self.disable_enforce_available_locales
+      saved_enforce_available_locales = I18n.enforce_available_locales
+      I18n.enforce_available_locales = false
+      yield
+    ensure
+      I18n.enforce_available_locales = saved_enforce_available_locales
+    end
   end
 
 

data/lib/testcentricity_web/utility_helpers.rb

@@ -34,6 +34,10 @@ class String
     end
   end
 
+  def titlecase
+    "#{self.split.each{ |text| text.capitalize! }.join(' ')}"
+  end
+
   def is_int?
     Integer(self) && true rescue false
   end

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.2.20'
+  VERSION = '3.2.25'
 end

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -127,18 +127,19 @@ module TestCentricity
     def self.initialize_appium
       Environ.platform    = :mobile
       Environ.device_name = ENV['APP_DEVICE']
-      Environ.device_os   = ENV['APP_PLATFORM_NAME']
+      Environ.device_os   = ENV['APP_PLATFORM_NAME'].downcase.to_sym
       Environ.device_type = ENV['DEVICE_TYPE'] if ENV['DEVICE_TYPE']
+      Environ.device_os_version = ENV['APP_VERSION']
       Environ.device_orientation = ENV['ORIENTATION'] if ENV['ORIENTATION']
       Capybara.default_driver = :appium
       endpoint = 'http://localhost:4723/wd/hub'
       desired_capabilities = {
-          platformName:    ENV['APP_PLATFORM_NAME'],
-          platformVersion: ENV['APP_VERSION'],
+          platformName:    Environ.device_os,
+          platformVersion: Environ.device_os_version,
           browserName:     ENV['APP_BROWSER'],
-          deviceName:      ENV['APP_DEVICE']
+          deviceName:      Environ.device_name
       }
-      desired_capabilities[:avd] = ENV['APP_DEVICE'] if ENV['APP_PLATFORM_NAME'].downcase.to_sym == :android
+      desired_capabilities[:avd] = ENV['APP_DEVICE'] if Environ.device_os == :android
       desired_capabilities[:automationName] = ENV['AUTOMATION_ENGINE'] if ENV['AUTOMATION_ENGINE']
       if ENV['UDID']
         Environ.device = :device
@@ -148,30 +149,45 @@ module TestCentricity
         desired_capabilities[:xcodeSigningId] = ENV['TEAM_NAME'] if ENV['TEAM_NAME']
       else
         Environ.device = :simulator
-        desired_capabilities[:orientation] = ENV['ORIENTATION'].upcase if ENV['ORIENTATION']
+        desired_capabilities[:orientation] = Environ.device_orientation.upcase if Environ.device_orientation
         if Environ.device_os == :ios
-          desired_capabilities[:language] = ENV['LANGUAGE'] if ENV['LANGUAGE']
-          desired_capabilities[:locale]   = ENV['LOCALE'].gsub('-', '_') if ENV['LOCALE']
+          desired_capabilities[:language] = Environ.language if Environ.language
+          desired_capabilities[:locale]   = Environ.locale.gsub('-', '_') if Environ.locale
         end
       end
       desired_capabilities[:safariIgnoreFraudWarning] = ENV['APP_IGNORE_FRAUD_WARNING'] if ENV['APP_IGNORE_FRAUD_WARNING']
       desired_capabilities[:safariInitialUrl]       = ENV['APP_INITIAL_URL'] if ENV['APP_INITIAL_URL']
       desired_capabilities[:safariAllowPopups]      = ENV['APP_ALLOW_POPUPS'] if ENV['APP_ALLOW_POPUPS']
+
+      desired_capabilities[:autoAcceptAlerts]       = ENV['AUTO_ACCEPT_ALERTS'] if ENV['AUTO_ACCEPT_ALERTS']
+      desired_capabilities[:autoDismissAlerts]      = ENV['AUTO_DISMISS_ALERTS'] if ENV['AUTO_DISMISS_ALERTS']
+      desired_capabilities[:isHeadless]             = ENV['HEADLESS'] if ENV['HEADLESS']
+
       desired_capabilities[:newCommandTimeout]      = ENV['NEW_COMMAND_TIMEOUT'] if ENV['NEW_COMMAND_TIMEOUT']
       desired_capabilities[:noReset]                = ENV['APP_NO_RESET'] if ENV['APP_NO_RESET']
       desired_capabilities[:fullReset]              = ENV['APP_FULL_RESET'] if ENV['APP_FULL_RESET']
       desired_capabilities[:webkitDebugProxyPort]   = ENV['WEBKIT_DEBUG_PROXY_PORT'] if ENV['WEBKIT_DEBUG_PROXY_PORT']
       desired_capabilities[:webDriverAgentUrl]      = ENV['WEBDRIVER_AGENT_URL'] if ENV['WEBDRIVER_AGENT_URL']
-      desired_capabilities[:wdaLocalPort]           = ENV['WDA_LOCAL_PORT'] if ENV['WDA_LOCAL_PORT']
       desired_capabilities[:usePrebuiltWDA]         = ENV['USE_PREBUILT_WDA'] if ENV['USE_PREBUILT_WDA']
       desired_capabilities[:useNewWDA]              = ENV['USE_NEW_WDA'] if ENV['USE_NEW_WDA']
       desired_capabilities[:chromedriverExecutable] = ENV['CHROMEDRIVER_EXECUTABLE'] if ENV['CHROMEDRIVER_EXECUTABLE']
+      # set wdaLocalPort (iOS) or systemPort (Android) if PARALLEL_PORT is true
+      if ENV['PARALLEL'] && ENV['PARALLEL_PORT']
+        if Environ.device_os == :ios
+          desired_capabilities[:wdaLocalPort] = 8100 + ENV['TEST_ENV_NUMBER'].to_i
+        else
+          desired_capabilities[:systemPort] = 8200 + ENV['TEST_ENV_NUMBER'].to_i
+        end
+      else
+        desired_capabilities[:wdaLocalPort] = ENV['WDA_LOCAL_PORT'] if ENV['WDA_LOCAL_PORT']
+        desired_capabilities[:systemPort]   = ENV['SYSTEM_PORT'] if ENV['SYSTEM_PORT']
+      end
 
       Capybara.register_driver :appium do |app|
         appium_lib_options = { server_url: endpoint }
         all_options = {
-            appium_lib:  appium_lib_options,
-            caps:        desired_capabilities
+          appium_lib: appium_lib_options,
+          caps:       desired_capabilities
         }
         Appium::Capybara::Driver.new app, all_options
       end

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -528,11 +528,17 @@ module TestCentricity
 
     # Hover the cursor over an object
     #
+    # @param visible [Boolean, Symbol] Only find elements with the specified visibility:
+    #                                    * true - only finds visible elements.
+    #                                    * false - finds invisible _and_ visible elements.
+    #                                    * :all - same as false; finds visible and invisible elements.
+    #                                    * :hidden - only finds invisible elements.
+    #                                    * :visible - same as true; only finds visible elements.
     # @example
     #   basket_link.hover
     #
-    def hover
-      obj, type = find_element
+    def hover(visible = true)
+      obj, type = find_element(visible)
       object_not_found_exception(obj, type)
       obj.hover
     end
@@ -541,11 +547,17 @@ module TestCentricity
     #
     # @param x [Integer] X offset
     # @param y [Integer] Y offset
+    # @param visible [Boolean, Symbol] Only find elements with the specified visibility:
+    #                                    * true - only finds visible elements.
+    #                                    * false - finds invisible _and_ visible elements.
+    #                                    * :all - same as false; finds visible and invisible elements.
+    #                                    * :hidden - only finds invisible elements.
+    #                                    * :visible - same as true; only finds visible elements.
     # @example
     #   timeline_bar.hover_at(100, 5)
     #
-    def hover_at(x, y)
-      obj, = find_element
+    def hover_at(x, y, visible = true)
+      obj, = find_element(visible)
       raise "UI #{object_ref_message} not found" unless obj
       obj.hover_at(x, y)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.2.20
+  version: 3.2.25
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-05 00:00:00.000000000 Z
+date: 2021-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler