testcentricity_web 4.4.3 → 4.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8c968e47a6f1c58903fd78ecacef42a3a6897714fba982cdde8045c2079f80a
-  data.tar.gz: 3d863cb52a2384e6fdeb3128425797ebe9e42d6f53f58d222d3b4e680b19fec1
+  metadata.gz: 5c0d20bb936dba985ea48c3530e3c6230b1325b9d4a6566ed0d65543e8a76f12
+  data.tar.gz: 4301b1706050e1ede1de4c561eddd1fe27da5459890fe28b8a285cbb6d7e631d
 SHA512:
-  metadata.gz: 382f74e7baf7e34f7e2a02b602a91eb00029ced5bc518ddf967298ea95e18050592c03b51692372cf55b8f879d599155d07b1eaf5590d5c7a4376ee905613165
-  data.tar.gz: cd88dbd29452dcf44294a775e48ba939578cc2f1936229d630fffecaaf7afa0c2082e8b8ff2b6f1d530462d700e70128ab8f695587538872ef6724c2eecbb232
+  metadata.gz: 209f0cee6d68f976a46f6978038450f6168c43ef4d10bf4797eb24a737f38c48265e8489c8cf13b449b028a3978801265b1ad3bf38c67a5acec082a54224e3ee
+  data.tar.gz: 81a44b0962710c3c3a57f0fcbcca72b444e2e21bdb0067b7e944e181dc57036a86bc3de5d9b0358d1f2aa8c6bbd35a5cbf0094c5e2feb719ad49187b27977369

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.4.4] - 08-JAN-2024
+
+### Fixed
+* `List.get_list_item` no longer returns `nil`.
+
+
 ## [4.4.3] - 24-DEC-2023
 
 ### Changed

data/LICENSE.md

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

data/README.md

@@ -38,6 +38,19 @@ An example project that demonstrates the implementation of a page object model f
 can be found [here](https://github.com/TestCentricity/tc_web_sample).
 
 
+### Which gem should I use?
+
+* The TestCentricity **Web** gem only supports testing of web interfaces via desktop and mobile web browsers
+* The TestCentricity **Mobile** gem only supports testing of native iOS and/or Android mobile apps
+* The TestCentricity gem supports testing of native mobile apps and/or web interfaces via desktop and mobile web browsers.
+
+| Tested platforms                                   | TestCentricity Web | TestCentricity Mobile | TestCentricity |
+|----------------------------------------------------|--------------------|-----------------------|----------------|
+| Desktop/mobile web browsers only                   | Yes                | No                    | No             |
+| Native mobile iOS and/or Android apps only         | No                 | Yes                   | No             |
+| Native mobile apps and desktop/mobile web browsers | 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
@@ -1588,7 +1601,7 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:local_<browserName>` - e.g. `:local_chrome` or `:local_edge_headless`.
 
 Below is an example of an `options` hash for specifying a connection to a locally hosted Firefox desktop web browser. The
@@ -1661,7 +1674,7 @@ You can run your tests against mobile device browsers that are emulated within a
 browser on macOS or Windows. The specified mobile browser's user agent, CSS screen dimensions, and default screen orientation
 will be automatically set within the local Chrome browser instance. You may also specify the emulated device's screen orientation.
 
-⚠️ For best results when testing against mobile web browsers, you should run your tests against iOS and Android simulators
+> ⚠️ For best results when testing against mobile web browsers, you should run your tests against iOS and Android simulators
 or physical devices, either hosted locally or via a remotely cloud hosted service.
 
 For locally hosted emulated mobile web browsers, the `WEB_BROWSER` Environment Variable must be set to one of the values
@@ -1748,7 +1761,7 @@ To change the emulated device's screen orientation from the default setting, set
     }
     WebDriverConnect.initialize_web_driver(options)
 
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:local_<browserName>` - e.g. `:local_ipad_pro_12_9` or `:local_pixel_6`.
 
 Below is an example of an `options` hash for specifying a connection to a locally hosted emulated mobile Safari web browser
@@ -1845,10 +1858,10 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+>ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:remote_<browserName>` - e.g. `:remote_chrome` or `:remote_edge_headless`.
-
-ℹ️ If an `endpoint:` is not specified in the `options`hash, then the default remote endpoint URL of `http://localhost:4444/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options`hash, then the default remote endpoint URL of `http://localhost:4444/wd/hub`
 will be used.
 
 Below is an example of an `options` hash for specifying a connection to a grid hosted Chrome desktop web browser. The
@@ -1939,10 +1952,10 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `appium_safari`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL of `http://localhost:4723/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL of `http://localhost:4723/wd/hub`
 will be used.
 
 Below is an example of an `options` hash for specifying a connection to a locally hosted mobile Safari web browser running
@@ -1969,7 +1982,8 @@ orientation to portrait mode.
 
 You can run your mobile web tests against the mobile Chrome or Android browser on emulated Android devices using Appium and
 Android Studio on macOS. You must install Android Studio, the desired Android version-specific virtual device emulators, and
-Appium. Refer to [this page](https://appium.io/docs/en/2.2/quickstart/uiauto2-driver/) for information on configuring Appium to work with the Android SDK.
+Appium. Refer to [this page](https://appium.io/docs/en/2.2/quickstart/uiauto2-driver/) for information on configuring Appium to work with the Android SDK. Refer to [this page](https://github.com/appium/appium-uiautomator2-driver)
+for information regarding specifying  Appium capabilities that are specific to the UiAutomator2 driver.
 
 The Appium server must be running prior to invoking Cucumber to run your features/scenarios. Refer to [**section 8.6.3 (Starting and Stopping Appium Server)**](#starting-and-stopping-appium-server) below.
 
@@ -2025,10 +2039,10 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `appium_chrome`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL of `http://localhost:4723/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL of `http://localhost:4723/wd/hub`
 will be used.
 
 Below is an example of an `options` hash for specifying a connection to a locally hosted mobile Chrome web browser running
@@ -2120,9 +2134,9 @@ method upon completion of your test suite to stop the Local instance. Place the
 
 #### Remote Desktop Browsers on the BrowserStack Service
 
-For remotely hosted desktop web browsers on the BrowserStack service, refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities?tag=selenium-4)
+For remotely hosted desktop web browsers on the BrowserStack service, refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/docs/automate/capabilities)
 for information regarding the options and capabilities available for the various supported desktop operating systems and
-web browsers.
+web browsers. Select the **Legacy** Integration method tab and the **W3C Protocol** tab on the capabilities page.
 
 ##### BrowserStack Desktop Browser using Environment Variables
 
@@ -2172,12 +2186,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:browserstack_<browserName>` - e.g. `:browserstack_chrome` or `:browserstack_safari`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['BS_USERNAME']}:#{ENV['BS_AUTHKEY']}@hub-cloud.browserstack.com/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
+> 
+> `https://#{ENV['BS_USERNAME']}:#{ENV['BS_AUTHKEY']}@hub-cloud.browserstack.com/wd/hub`
 
 This default endpoint requires that the `BS_USERNAME` Environment Variable is set to your BrowserStack account user name and
 the `BS_AUTHKEY` Environment Variable is set to your BrowserStack access key.
@@ -2216,9 +2230,9 @@ test configuration options.
 
 #### Remote Mobile Browsers on the BrowserStack Service
 
-For remotely hosted mobile web browsers on the BrowserStack service, refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities?tag=selenium-4)
+For remotely hosted mobile web browsers on the BrowserStack service, refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/docs/automate/capabilities)
 for information regarding the options and capabilities available for the various supported mobile operating systems, devices,
-and web browsers.
+and web browsers. Select the **Legacy** Integration method tab and the **W3C Protocol** tab on the capabilities page.
 
 ##### BrowserStack Mobile Browser using Environment Variables
 
@@ -2269,12 +2283,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:browserstack_<browserName>` - e.g. `:browserstack_chrome` or `:browserstack_safari`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['BS_USERNAME']}:#{ENV['BS_AUTHKEY']}@hub-cloud.browserstack.com/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
+>
+> `https://#{ENV['BS_USERNAME']}:#{ENV['BS_AUTHKEY']}@hub-cloud.browserstack.com/wd/hub`
 
 This default endpoint requires that the `BS_USERNAME` Environment Variable is set to your BrowserStack account user name and
 the `BS_AUTHKEY` Environment Variable is set to your BrowserStack access key.
@@ -2358,12 +2372,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:saucelabs_<browserName>` - e.g. `:saucelabs_chrome` or `:saucelabs_safari`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['SL_USERNAME']}:#{ENV['SL_AUTHKEY']}@ondemand.#{ENV['SL_DATA_CENTER']}.saucelabs.com:443/wd/hub`
+>
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
+>
+> `https://#{ENV['SL_USERNAME']}:#{ENV['SL_AUTHKEY']}@ondemand.#{ENV['SL_DATA_CENTER']}.saucelabs.com:443/wd/hub`
 
 This default endpoint requires that the `SL_USERNAME` Environment Variable is set to your Sauce Labs account user name, the
 `SL_AUTHKEY` Environment Variable is set to your Sauce Labs access key, and the `SL_DATA_CENTER` Environment Variable is
@@ -2451,12 +2465,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:saucelabs_<browserName>` - e.g. `:saucelabs_chrome` or `:saucelabs_safari`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['SL_USERNAME']}:#{ENV['SL_AUTHKEY']}@ondemand.#{ENV['SL_DATA_CENTER']}.saucelabs.com:443/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
+> 
+> `https://#{ENV['SL_USERNAME']}:#{ENV['SL_AUTHKEY']}@ondemand.#{ENV['SL_DATA_CENTER']}.saucelabs.com:443/wd/hub`
 
 This default endpoint requires that the `SL_USERNAME` Environment Variable is set to your Sauce Labs account user name, the
 `SL_AUTHKEY` Environment Variable is set to your Sauce Labs access key, and the `SL_DATA_CENTER` Environment Variable is
@@ -2532,12 +2546,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:testingbot_<browserName>` - e.g. `:testingbot_chrome` or `:testingbot_microsoftedge`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['TB_USERNAME']}:#{ENV['TB_AUTHKEY']}@hub.testingbot.com/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
+> 
+> `https://#{ENV['TB_USERNAME']}:#{ENV['TB_AUTHKEY']}@hub.testingbot.com/wd/hub`
 
 This default endpoint requires that the `TB_USERNAME` Environment Variable is set to your TestingBot account user name and
 the `TB_AUTHKEY` Environment Variable is set to your TestingBot access key.
@@ -2616,12 +2630,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:testingbot_<browserName>` - e.g. `:testingbot_chrome` or `:testingbot_safari`.
-
-ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['TB_USERNAME']}:#{ENV['TB_AUTHKEY']}@hub.testingbot.com/wd/hub`
+> 
+> ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
+> 
+> `https://#{ENV['TB_USERNAME']}:#{ENV['TB_AUTHKEY']}@hub.testingbot.com/wd/hub`
 
 This default endpoint requires that the `TB_USERNAME` Environment Variable is set to your TestingBot account user name and
 the `TB_AUTHKEY` Environment Variable is set to your TestingBot access key.
@@ -2698,12 +2712,12 @@ When using the `options` hash, the following options and capabilities must be sp
     }
     WebDriverConnect.initialize_web_driver(options)
 ```
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:lambdatest_<browserName>` - e.g. `:lambdatest_chrome` or `:lambdatest_safari`.
-
+> 
 ℹ️ If an `endpoint:` is not specified in the `options` hash, then the default remote endpoint URL will be set to the following:
-
-`https://#{ENV['LT_USERNAME']}:#{ENV['LT_AUTHKEY']}@hub.lambdatest.com/wd/hub`
+> 
+> `https://#{ENV['LT_USERNAME']}:#{ENV['LT_AUTHKEY']}@hub.lambdatest.com/wd/hub`
 
 This default endpoint requires that the `LT_USERNAME` Environment Variable is set to your LambdaTest account user name and
 the `LT_AUTHKEY` Environment Variable is set to your LambdaTest access key.
@@ -2760,7 +2774,7 @@ All other required capabilities specified by the hosting service configuration d
     }
     WebDriverConnect.initialize_web_driver(options)
 
-ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
+> ℹ️ If an optional user defined `driver_name:` is not specified in the `options` hash, the default driver name will be set to
 `:custom_<browserName>` - e.g. `:custom_chrome` or `:custom_safari`.
 
 Prior to calling the `TestCentricity::WebDriverConnect.initialize_web_driver` method, you must set `Environ.platform` to
@@ -2842,7 +2856,7 @@ these in in your`cucumber.yml` file). Before you can use the BrowserStack, Sauce
 you will need to replace the *INSERT USER NAME HERE* and *INSERT PASSWORD HERE* placeholder text with your user account
 and authorization code for the cloud service(s) that you intend to connect with.
 
-⚠️ Cloud service credentials should not be stored as text in your `cucumber.yml` file where it can be exposed by anyone
+> ⚠️ Cloud service credentials should not be stored as text in your `cucumber.yml` file where it can be exposed by anyone
 with access to your version control system.
 
 
@@ -3126,7 +3140,7 @@ area sub-folders as needed. Likewise, `PageSection` class definitions should be
 ---
 ## Copyright and License
 
-TestCentricity™ Framework is Copyright (c) 2014-2023, Tony Mrozinski.
+TestCentricity™ Framework is Copyright (c) 2014-2024, Tony Mrozinski.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following

data/lib/testcentricity_web/appium_server.rb

@@ -18,12 +18,10 @@ module TestCentricity
     def start
       # terminate any currently running Appium Server
       if running?
-        # :nocov:
         system('killall -9 node')
         puts 'Terminating existing Appium Server'
         sleep(5)
         puts 'Appium Server is being restarted'
-        # :nocov:
       else
         puts 'Appium Server is starting'
       end
@@ -40,7 +38,7 @@ module TestCentricity
     # Check to see if Appium Server is running
     #
     def running?
-      response = nil
+      response = false
       begin
         response = Net::HTTP.get_response(URI('http://0.0.0.0:4723/wd/hub/sessions'))
       rescue

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.4.3'
+  VERSION = '4.4.4'
 end

data/lib/testcentricity_web/web_elements/list.rb

@@ -90,7 +90,7 @@ module TestCentricity
         item.delete!("\n")
         item.delete!("\r")
         item.delete!("\t")
-        item.strip!
+        item
       end
 
       # Return the number of items in a list object.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.4.3
+  version: 4.4.4
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-24 00:00:00.000000000 Z
+date: 2024-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler