testcentricity_web 4.5.7 → 4.5.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81e3ce8ee09530abd102258e25235af8032599eab54e067784ae3eb6349d2e18
-  data.tar.gz: 66f82ab5ceede12f34095be1aa4eb96d59c7f4e1adaade724e54aa39f0e7a222
+  metadata.gz: 6a51581c1a0aa1b5c14e1f4ca5a99767f05c956d79e62fe3be21864a1b3e3b69
+  data.tar.gz: c859c5da5b37a6c1cfc75ea34d04d612d18e35f62bc1419e1fbe27ffe5d0ef79
 SHA512:
-  metadata.gz: 1b954744d822885d35b580c233153f3346c4b31ea9ef7667916d816882ff0e3499e3fd162c80ff587529ae6f2c261dd209993f7db7b64af692d7edb7b2843329
-  data.tar.gz: 1b31ffb82f255889fb5403c5fc4aa9ffc9643715963eedb7abf6a49cfa76f4cb17cfbaa28d6a638665a9fac30e24eeb000911b83c44af30e0fdd1582b36ce1a7
+  metadata.gz: 8858b75a894d4512ef69f560727b8d9c8a0700e10c7865ffb5e0a5903a604a7a8998d759549b0761c9fbd8f836a1398f1097c1a04cea9f04e67b57d4aa5285c1
+  data.tar.gz: dc154b9acd9f376a88375fc2945913e2b99cf47c5589975110c3de85fbf844e10d94cc0d4eb10be81f27e50026bb67cf2297509a49ac7d2a4c5752aaf71f5d59

data/CHANGELOG.md

@@ -2,6 +2,24 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.5.9] - 23-JUNE-2024
+
+### Changed
+
+* Updated `selenium-webdriver` gem to version 4.22.0.
+
+
+## [4.5.8] - 21-MAY-2024
+
+### Changed
+
+* Setting `DOWNLOADS` Environment Variable to `true` will create a `/downloads` folder which will be used as the destination
+for files that are downloaded by your automated tests. You know longer need to manually create the `/downloads` folder.
+* Updated `appium_lib` gem to version 15.1.0.
+* Updated `appium_lib_core` gem to version 9.1.1.
+* Updated `selenium-webdriver` gem to version 4.21.1.
+
+
 ## [4.5.7] - 25-APR-2024
 
 ### Changed

data/README.md

@@ -1,4 +1,4 @@
-# TestCentricity™ Web
+# TestCentricity™ For Web
 
 [![Gem Version](https://badge.fury.io/rb/testcentricity_web.svg)](https://badge.fury.io/rb/testcentricity_web)
 [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
@@ -7,12 +7,12 @@
 [![Docs](https://img.shields.io/badge/docs-rubydoc-blue.svg)](http://www.rubydoc.info/gems/testcentricity_web)
 
 
-The TestCentricity™ Web core framework for desktop and mobile web browser-based app testing implements a Page Object Model
+The TestCentricity™ For Web core framework for desktop and mobile web browser-based app testing implements a Page Object Model
 DSL for use with Cucumber (version 7.x or greater) or RSpec, and Selenium-Webdriver. It also facilitates the configuration
 of the appropriate Selenium-Webdriver capabilities required to establish connections with one or more local or cloud hosted
 desktop or mobile web browsers.
 
-The TestCentricity™ Web gem supports connecting to, and running automated tests against the following target web browsers:
+The TestCentricity™ For Web gem supports connecting to, and running automated tests against the following target web browsers:
 * locally hosted desktop browsers (Chrome, Edge, Firefox, or Safari)
 * locally hosted "headless" Chrome, Firefox, or Edge browsers
 * remote desktop and emulated mobile web browsers hosted on Selenium Grid 4 and Dockerized Selenium Grid 4 environments
@@ -34,8 +34,8 @@ A complete history of bug fixes and new features can be found in the {file:CHANG
 
 The RubyDocs for this gem can be found [here](https://www.rubydoc.info/gems/testcentricity_web).
 
-An example project that demonstrates the implementation of a page object model framework using Cucumber and TestCentricity™ Web
-can be found [here](https://github.com/TestCentricity/tc_multi_webdriver_sample).
+An example project that demonstrates the implementation of a page object model framework using TestCentricity™ For Web and
+Cucumber can be found [here](https://github.com/TestCentricity/tc_multi_webdriver_sample).
 
 
 ### Which gem should I use?
@@ -44,23 +44,21 @@ can be found [here](https://github.com/TestCentricity/tc_multi_webdriver_sample)
 
 ### Which gem should I use?
 
-* The [TestCentricity **Web** gem](https://rubygems.org/gems/testcentricity_web) only supports testing of web interfaces via desktop and mobile web browsers
-* The [TestCentricity **Mobile** gem](https://rubygems.org/gems/testcentricity_mobile) only supports testing of native iOS and Android mobile apps
-* The [TestCentricity **Apps** gem](https://rubygems.org/gems/testcentricity_apps) only supports testing of MacOS desktop apps and native iOS and Android mobile apps
-* The TestCentricity gem supports testing of native mobile apps and/or web interfaces via desktop and mobile web browsers.
+* The [TestCentricity For **Web** gem](https://rubygems.org/gems/testcentricity_web) supports testing of web interfaces via desktop and mobile web browsers
+* The [TestCentricity For **Mobile** gem](https://rubygems.org/gems/testcentricity_mobile) supports testing of native iOS and Android mobile apps
+* The [TestCentricity For **Apps** gem](https://rubygems.org/gems/testcentricity_apps) supports testing of MacOS desktop apps and native iOS and Android mobile apps
 
-| Tested platforms                                   | TestCentricity Web | TestCentricity Mobile | TestCentricity Apps | TestCentricity |
-|----------------------------------------------------|--------------------|-----------------------|---------------------|----------------|
-| Desktop/mobile web browsers only                   | Yes                | No                    | No                  | No             |
-| Native mobile iOS and/or Android apps only         | No                 | Yes                   | Yes                 | No             |
-| MacOS desktop apps                                 | No                 | No                    | Yes                 | No             |
-| Native mobile apps and desktop/mobile web browsers | No                 | No                    | No                  | Yes            |
+| Tested platforms                            | TestCentricity For Web | TestCentricity For Mobile | TestCentricity For Apps |
+|---------------------------------------------|:-:|:-:|:-:|
+| Desktop/mobile web browsers only            | Yes                    | No                        | No                      |
+| Native mobile iOS and/or Android apps only  | No                     | Yes                       | Yes                     |
+| MacOS desktop apps                          | No                     | No                        | Yes                     |
 
 
 ## Installation
 
-TestCentricity Web version 4.4 and above requires Ruby version 3.0.0 or later. To install the TestCentricity Web gem, add
-this line to your automation project's `Gemfile`:
+TestCentricity For Web version 4.4 and above requires Ruby version 3.0.0 or later. To install the TestCentricity For Web gem,
+add this line to your automation project's `Gemfile`:
 
     gem 'testcentricity_web'
 
@@ -466,7 +464,7 @@ Once your `PageObject` has been instantiated, you can call its `PageSection` met
 `PageObjects` and `PageSections` are typically made up of UI elements like text fields, check boxes, select lists (combo
 boxes), radio buttons, tables, ordered and unordered lists, buttons, images, HTML5 video or audio player objects, etc.
 UI elements are declared and instantiated within the class definition of the `PageObject` or `PageSection` in which they
-are contained. With TestCentricity Web, all UI elements are based on the `UIElement` class.
+are contained. With TestCentricity For Web, all UI elements are based on the `UIElement` class.
 
 
 ### Declaring and Instantiating UIElements
@@ -1625,9 +1623,9 @@ Below is an example of an `options` hash for specifying a connection to a locall
 #### Testing File Downloads With Desktop Browsers
 
 File download functionality can be tested with locally hosted instances of Chrome, Edge, or Firefox desktop browsers. Your
-automation project must include a `/downloads` folder which is used as the destination for files that are downloaded by
-your automated tests. The `/downloads` folder must be at the same level as the `/config` and `/features` folders, as depicted
-below:
+automation project must set the `DOWNLOADS` Environment Variable to `true`, which will result in a `/downloads` folder being
+created, which will be used as the destination for files that are downloaded by your automated tests. The `/downloads` folder
+will be at the same level as the `/config` and `/features` folders, as depicted below:
 
         📁 my_automation_project/
         ├── 📁 config/
@@ -3161,7 +3159,7 @@ area sub-folders as needed. Likewise, `PageSection` class definitions should be
 ---
 ## Web Test Automation Framework Implementation
 
-![TestCentricity Web Framework Overview](https://raw.githubusercontent.com/TestCentricity/testcentricity_web/main/.github/images/tc_overview.jpg "TestCentricity Web Framework Overview")
+![TestCentricity For Web Framework Overview](https://raw.githubusercontent.com/TestCentricity/testcentricity_web/main/.github/images/tc_overview.jpg "TestCentricity For Web Framework Overview")
 
 
 ---

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.5.7'
+  VERSION = '4.5.9'
 end

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -157,6 +157,10 @@ module TestCentricity
       @initialized = false
     end
 
+    def self.downloads_path
+      @downloads_path
+    end
+
     def self.initialize_browser_size
       # tile browser windows if BROWSER_TILE environment variable is true and running in multiple parallel threads
       if ENV['BROWSER_TILE'] && (Environ.parallel || @drivers.length > 1)
@@ -216,8 +220,12 @@ module TestCentricity
 
     def self.initialize_downloads
       @drivers = {}
-      # set downloads folder path
       @downloads_path = "#{Dir.pwd}/downloads"
+      # create downloads folder if it doesn't already exist
+      if ENV['DOWNLOADS'] && ENV['DOWNLOADS'].to_bool
+        Dir.mkdir(@downloads_path) unless Dir.exist?(@downloads_path)
+      end
+
       if ENV['PARALLEL']
         Environ.parallel = true
         Environ.process_num = ENV['TEST_ENV_NUMBER']
@@ -486,7 +494,7 @@ module TestCentricity
                   else
                     # define desktop browser options
                     bs_options[:resolution] = ENV['RESOLUTION'] if ENV['RESOLUTION']
-                    bs_options[:seleniumVersion] = '4.19.1'
+                    bs_options[:seleniumVersion] = '4.21.0'
                     {
                       browserName: browser,
                       browserVersion: ENV['BS_VERSION'],
@@ -556,7 +564,7 @@ module TestCentricity
                   else
                     # define desktop browser options
                     tb_options['screen-resolution'] = ENV['RESOLUTION'] if ENV['RESOLUTION']
-                    tb_options['selenium-version'] = '4.18.1'
+                    tb_options['selenium-version'] = '4.20.0'
                   end
                   {
                     browserName: browser,
@@ -619,7 +627,7 @@ module TestCentricity
                   # define mobile device options
                   if ENV['SL_PLATFORM']
                     sl_options[:deviceOrientation] = ENV['ORIENTATION'].upcase if ENV['ORIENTATION']
-                    sl_options[:appium_version] = '1.22.3'
+                    sl_options[:appium_version] = '2.1.3'
                     {
                       browserName: browser,
                       platform_name: ENV['SL_PLATFORM'],
@@ -678,7 +686,7 @@ module TestCentricity
                     platformName: ENV['LT_OS'],
                     resolution: ENV['RESOLUTION'],
                     name: test_context_message,
-                    selenium_version: '4.13.0',
+                    selenium_version: '4.21.0',
                   }
                   # define the optional LambdaTest options
                   lt_options[:project] = ENV['AUTOMATE_PROJECT'] if ENV['AUTOMATE_PROJECT']
@@ -746,7 +754,7 @@ module TestCentricity
       options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
       if browser == :chrome_headless || browser == :edge_headless
         Environ.headless = true
-        options.add_argument('--headless')
+        options.add_argument('--headless=new')
         options.add_argument('--disable-gpu')
       end
       options

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.5.7
+  version: 4.5.9
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-25 00:00:00.000000000 Z
+date: 2024-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -156,14 +156,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 15.0.0
+        version: 15.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 15.0.0
+        version: 15.1.0
 - !ruby/object:Gem::Dependency
   name: browserstack-local
   requirement: !ruby/object:Gem::Requirement
@@ -268,14 +268,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.20.0
+        version: 4.22.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.20.0
+        version: 4.22.0
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -306,13 +306,13 @@ dependencies:
         version: '0'
 description: |2-
 
-      The TestCentricity™ Web core framework for desktop and mobile web browser-based app testing implements a Page Object
+      The TestCentricity™ For Web core framework for desktop and mobile web browser-based app testing implements a Page Object
       Model DSL for use with Cucumber or RSpec, and Selenium-Webdriver. The gem also facilitates the configuration of the
       appropriate Selenium-Webdriver capabilities required to establish connections to locally hosted desktop browsers,
       locally hosted emulated mobile browsers (iOS, Android, etc.) running within a local instance of Chrome, mobile Safari
       browsers on iOS device simulators or physical iOS devices, mobile Chrome browsers on Android Studio virtual device
-      emulators, or cloud hosted desktop or mobile web browsers (using BrowserStack, Sauce Labs, TestingBot, or
-      LambdaTest services).
+      emulators, or cloud hosted desktop or mobile web browsers (using BrowserStack, Sauce Labs, TestingBot, or LambdaTest
+      services).
 email:
 - testcentricity@gmail.com
 executables: []