carina

Enhancements

• [#1944][#1958] Refactored to use Zebrunner carina-proxy
• [#1968] Added description about read_timeout param
• [#1960] Increased timeout of session start for desktop browsers
• [#1952] Added drag and drop method to the IMobileUtils interface
• [#1951] Added methods from HasClipboard, HasSettings, HasCapabilities interfaces to the IMobileUtils interface
• [#1947] Added opportunity to create custom driver listener with driver as constructor param in priority

Fixes

• [#1949] Localized locators don't work for IOS

Known Issues

• N/A

Dependencies Updates

• com.qaprosoft.carina-proxy 8.0.2 -> com.zebrunner.carina-proxy 1.0.0

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 8.0.3
• Rebuild the project mvn -U clean compile install
• Update package names as follows:

  com.qaprosoft.carina.browserupproxy.* -> com.zebrunner.carina.proxy.browserup.*
  com.qaprosoft.carina.proxy.SystemProxy -> com.zebrunner.carina.proxy.SystemProxy
  

Enhancements

• [#1927] Switched to the independent carina-utils project
• [#1934] Refactored getSuiteResult method of EmailReportGenerator to return TestResult object
• [#1906] Optimized findExtendedWebElements method

Fixes

• [#1936] Refactored "findExtendedWebElements" method in compliance with Selenium "findElements"
• [#1930] getDefaultCondition method of ExtendedWebElement class works incorrectly

Known Issues

• N/A

Dependencies Updates

• com.qaprosoft.carina-utils 8.0.1 -> com.zebrunner.carina-utils 1.0.0
• com.zebrunner.agent-testng-pluggable 1.9.0 -> 1.9.1

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 8.0.2 and com.zebrunner.agent-core dependency to 1.9.1
• Rebuild the project mvn -U clean compile install
• Update package names as follows:

  com.qaprosoft.carina.core.foundation.utils.ownership.* -> com.zebrunner.carina.core.registrar.ownership.*
  com.qaprosoft.carina.core.foundation.utils.tag.* -> com.zebrunner.carina.core.registrar.tag.*
  com.qaprosoft.carina.core.foundation.utils.Messager -> com.zebrunner.carina.utils.messager.Messager
  com.qaprosoft.carina.core.foundation.utils.ZebrunnerNameResolver -> com.zebrunner.carina.core.testng.ZebrunnerNameResolver
  com.qaprosoft.carina.core.foundation.utils.ParameterGenerator -> com.zebrunner.carina.utils.ParameterGenerator
  com.qaprosoft.carina.core.foundation.utils.* -> com.zebrunner.carina.utils.*
  com.qaprosoft.carina.core.foundation.report.* -> com.zebrunner.carina.utils.report.*
  com.qaprosoft.carina.core.foundation.retry.* -> com.zebrunner.carina.utils.retry.*
  com.qaprosoft.carina.core.foundation.commons.SpecialKeywords -> com.zebrunner.carina.utils.commons.SpecialKeywords
  com.qaprosoft.carina.core.foundation.listeners.TestnamingService -> com.zebrunner.carina.core.testng.TestNamingService
  com.qaprosoft.carina.core.foundation.exception.* -> com.zebrunner.carina.utils.exception.*
  com.qaprosoft.carina.core.foundation.performance.* -> com.zebrunner.carina.utils.performance.*
  

Enhancements

• [#1920] Bumped up TestNG to 7.6.1
• [#1919] Bumped up agent-testng-pluggable to 1.9.0
• [#1913] Added FAQ about location of mobile-specific methods
• [#1901] Refactored findExtendedWebElement(s) in DriverHelper class
• [#1778] Inform about custom property value usage at once per thread
• [#1525] Introduced new crypto_key_value property for CONFIG dataset
• [#1859] Bumped up Appium to 8.2.0
• [#1610] Updated more patterns / ways for users to customize their own testcase name
• [#1727] Inspected modules to make their fully independent project

Fixes

• [#1856] Unable to find CDP implementation matching error in logs
• [#1896] The implementation of findExtendedWebElements in Carina results in incorrect locator and thus unable to find element
• [#1054] Add support of data encryption in agent.properties
• [#1884] Register advance mobile doc article
• [#1869] Label with locale won't attach to test run
• [#1857] Taking a screenshot takes a minute

Known Issues

• N/A

Dependencies Updates

• com.qaprosoft.carina-crypto 8.0.0 -> com.zebrunner.carina-crypto 1.0.0
• com.zebrunner.agent-testng-pluggable 1.8.0 -> 1.9.0
• org.testng.testng 7.6.0 -> 7.6.1
• io.appium.java-client 8.1.1 -> 8.2.0
• org.apache.commons.commons-configuration 2 2.7 -> 2.8.0

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 8.0.1 and com.zebrunner.agent-core dependency to 1.9.0
• Rebuild the project mvn -U clean compile install
• Make sure to address compilation failures if CryptoTool was used directly
• Reuse crypto_key_value feature using env variable instead of crypto_key_path which is not available anymore [#1525]

Enhancements

• [#1882] Added setClipboardText method to the DriverHelper class
• [#1879] Bumped up commons text to 1.10.0 and commons-configuration2 to 2.8.0

Fixes

• [#1871] Label with locale won't attach to test run
• [#1862] MethodOwner annotation rewrites maintainer of all test methods after itself

Known Issues

• N/A

Dependencies Updates

• commons-configuration2 2.7 -> 2.8.0
• commons-text from commons-configuration2 to 1.10.0

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.27
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1822] Swapped BrowserMob to BrowserUp proxy
• [#1804] Refactored to replace WebDriverEventListener and EventFiringWebDriver
• [#1732] Decommissioned everything related to IE
• [#1623] Bumped up to TestNG 7.6.0
• [#1517] Replaced deprecated DesiredCapabilities with a new Selenium 4 compatible approach
• [#1490] Bumped up to Selenium 4.0.0
• [#1485] Generated Advanced->Mobile article with extra information
• [#1483] Added Appium 2.0 features support throughout the framework
• [#1418] Renamed TESTRAIL_PROJECT_ID and TESTRAIL_SUITE_ID values
• [#1398] Reviewed and refactored IAndroidUtils methods
• [#1380] IAndroidUtils: made openURL call from this mobile interface in DriverHelper
• [#1351] Investigated the possibility to remove support of customized env_arg_resolver
• [#1338] Investigated the possibility to remove CarinaListener static block
• [#739] Added soap test example with valid documentation steps
• [#659] Investigated the possibility to switch from application to browser during the test (mobile)

Fixes

• N/A

Known Issues

• N/A

Dependencies Updates

• org.testng.testng 7.5 -> 7.6.0
• org.seleniumhq.selenium.* 3.141.59 -> 4.4.0
• io.appium.java-client 7.6.0 -> 8.1.1
• com.google.guava.guava 29.0-jre -> 31.1-jre
• com.zebrunner.agent-testng-pluggable 1.7.4 -> 1.8.0
• net.lightbody.bmp.browsermob-core 2.1.5 -> com.browserup.browserup-proxy-core 2.1.2
• io.netty.netty-all 4.1.42.Final -> 4.1.80.Final

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 8.0.0 and com.zebrunner.agent-core dependency to 1.8.0
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+
• Full migration path still to be defined

Enhancements

• N/A

Fixes

• N/A

Known Issues

• N/A

Dependencies Updates

• com.zebrunner.agent-testng-pluggable 1.7.2 -> 1.7.4

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.26 and com.zebrunner.agent-core dependency to 1.7.4
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1807] Updated DataProvider article by providing detailed info on howto make a test row unique using TUID

Fixes

• [#1820] generateByForList did not correctly process the tagName locator
• [#1816] API: Unable to truncate values in the Carina framework with ValidateResponse method

Known Issues

• N/A

Dependencies Updates

• N/A

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.25
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1793] Investigated the possibility to load/parse all config.properties inside transitive carina sub-modules
• [#1791] Added instructions about extra parameter inside pom.xml to detect TUID's
• Api methods inheritance support was added

Fixes

• [#1773] findExtendedWebElement(s) create element(s) with incorrect context

Known Issues

• N/A

Dependencies Updates

• com.zebrunner.agent-testng-pluggable 1.7.1 -> 1.7.2

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.24
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1786] Handled the browserstack use-case
• [#1775] Provided an example of the ExtendedWebElement declaration with dynamic xpath
• [#1763][#1537] Don't show parameters in the logs with a default value

Fixes

• [#1782] By.className was not supported by findExtendedWebElements

Known Issues

• N/A

Dependencies Updates

• NA

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.23
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1761] Allowed reading env variables for all configuration params
• [#1760] Replaced deprecated TestRail.setCaseId with setTestCaseId
• [#1725] Added auto-download sample test to archetype
• [#1723] Added auto-download files option for MicrosoftEdge

Fixes

• [#1586][#1767] Java native crash on browsermob proxy server start due to the io.netty upgrade
• [#1752] captureByRule does not make screenshots for failure
• [#1749] aws s3 manager cannot init builder if amazon profile with region is absent

Known Issues

• N/A

Dependencies Updates

• [#1765] com.zebrunner.agent-testng-pluggable 1.7.0 -> 1.7.1
• [#1755] com.fasterxml.jackson.core 2.11.0 -> 2.13.3
• [#1758] com.google.code.gson:gson: 2.8.9 -> 2.9.0

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.22 and zebrunner agent-core to 1.7.1
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+
• Potentially new property s3_region=us-east-1 must be declared in your _config.properties file due to the changes in [#1749]

Enhancements

• [#1730] Removed deprecated health_check_class and health_check_methods
• [#1729][#1728][#1716][#1675] Updated doc structure using F.A.Q.
• [#1722] Added the ability to get and verify local and remote auto downloaded artifacts
• [#1712] Removed/commented retry_interval=5 from archetype
• [#1711][#1708] Screenshotting: removed unused methods
• [#1701] Hid stale exception onto the debug level in doAction before release
• [#1700] Restored auto-healing of staled elements but using searchContext
• [#1698] Refactored waitUntilElementDisappear in ExtendedWebElement
• [#1696] Bumped up to 7.5 TestNG
• [#1693] Implemented screenshots for visible areas on a failure and driver exception
• [#1661] Implemented the possibility for the ExtendedWebElement element to refresh itself

Fixes

• [#1733] decommission SKIP_ALL and SKIP_ALL_ALREADY_PASSED TestResultTypes
• [#1731] core_log_level=DEBUG is not applicable for updating app path (s3, appcenter and azure)
• [#1717] Web demo test: Test is running 1 hour+
• [#1714] Screenshotting for mobile (Android) doesn't work
• [#1713] Archetype: thread_count is written mistakenly
• [#1707] Hid screenshot failure for NoSuchSessionException onto the debug layer
• [#1706] Disabled retries for frame detach error
• [#1695] isVisible should return false for stale elements
• [#1691] L10N Localized annotation does not work when elements are nested and the parent element does not have an annotation
• [#1679] L10N: made assertion threads dependent
• [#1409] Component methods use xpaths from other components

Known Issues

• [#1752] captureByRule don't make screenshot for failure
• [#1749] aws s3 manager can't init builder if amazon profile with region is absent
  As workaround declare AWS_REGION=us-east-1 env var

Dependencies Updates

• [#1696] org.testng 7.4.0 -> 7.5
• com.zebrunner.agent-testng-pluggable 1.6.7 -> 1.7.0

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.4.21 and zebrunner agent-core to 1.7.0
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+
• Adjust broken changes with ExtendedWebElement constructor:

  // old constructor
  ExtendedWebElement alert = new ExtendedWebElement(By.xpath(String.format("//*[@text='%s']", alertBody)), "alert", driver);
  // as a workaround provide one more time driver which will be used as searchContext
  ExtendedWebElement alert = new ExtendedWebElement(By.xpath(String.format("//*[@text='%s']", alertBody)), "alert", driver, driver);
  // For long run try to avoid using constructor on your own
  

• Adjust broken changes with ReportContext if any (auto download artifacts functionality refactored a lot #1722)

Enhancements

• [#1687] Improved retry interval depending on the overall timeout value
• [#1671] Implemented downloadArtifacts by pattern
• [#1639] LogicUtils: improved $ignore placeholder for opening url verification
• [#1628] Refactored clickAny to reuse direct element calls after waiter

Fixes

• [#1689][#1690] Better handlers for WebDriverExceptions disconnected: received Inspector.detached event and target frame detached delivered
• [#1685] Unable to execute webdriver commands after interrupted waiter
• [#1684] Hotfix for AmazonS3Manager (>1000 objects)
• [#1662] Can't switch to iframe if it's inside a component

Known Issues

• N/A

Dependencies Updates

• N/A

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.3.20
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1658] Reviewed dependencies tree and mitigated spring-context vulnerability
• [#1654] Improved driver command retries for web and disabled for mobile (appium)
• [#1652] TestRail cases are now assigned even if suiteId is not accessible
• [#1647] Ported changes to archetype about polling api interval and adjusted the documentation
• [#1637] Reverted converting method to private in ICustomTypePage interface

Fixes

• [#1656] Carina tried to make a screenshot for NoSuchSessionException
• [#1589] @CaseInsensitiveXPath was not working in 7.3.15 for Android

Known Issues

• N/A

Dependencies Updates

• io.appium.java-client 7.5.1 -> 7.6.0
• org.springframework.spring-web 4.1.1.RELEASE -> 5.3.19

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.3.19
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1641] Hid the 'Please, inform Carina team about this warn providing logs...' warning log message
• [#1637] Converted the method to private in ICustomTypePage interface
• [#1636] Adjusted archetype sources
• [#1574] Bumped up the java appium client 7.5.1 -> 7.6.0
• [#330] Implemented API call fluentWait analogue with timeout and polling interval

Fixes

• [#1644] Removed the links onto the old qaprosoft nexus snapshot repo from the PR checker
• [#1638] clickbyJs was not shared for the ExtendedWebElement actions

Known Issues

• N/A

Dependencies Updates

• io.appium.java-client 7.5.1 -> 7.6.0

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.3.18
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1634] Switched to the released version of Zebrunner Reporting TestNG agent (1.6.7)
• [#1630] Printed elementName and by for formatted element
• [#1629] Hid stacktrace error during driver init for non-final attempts
• [#1575] Found a better way to operate with devices

Fixes

• [#1631] User unable to see execution logs after start Test jobs
• [#1624] Mobile waiters are broken and each operation starts for a minute or so
• [#1612] Unable to set waitForIdleTimeout in _config file
• [#1587] Emailable-report html file present skipped test scripts as failed
• [#1436] 404 error after redirection to Zebrunner landing page

Known Issues

• [#1638] clickbyJs not shared for the ExtendedWebElement actions

Dependencies Updates

• com.zebrunner.agent-testng-pluggable 1.6.6 -> 1.6.7

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.3.17
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1602] Documented the ognl validation feature

Fixes

• [#1604] Run was registered twice if executed from IDE
• [#1603] Video files were inaccessible due to the terminated old YouTube account
• [#1566] Migrated to the modern logger implementation
• [#1564] Incorrect URL for API call which is hardcoded in api.properties

Known Issues

• [#1638] clickbyJs not shared for the ExtendedWebElement actions

Dependencies Updates

• log4j 1.2.17 -> log4j2x 2.17.1

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.3.16
• Rebuild the project mvn -U clean compile install
• Remove all imports of old log4j and reuse slf4j instead. Recommended LOGGER declaration is:

  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  ...
  private static final Logger LOGGER = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
  

• Remove log4j.properties or log4j2x.properties from src/main/resources
• Be sure to use with Zebrunner CE 2.0+

Enhancements

• [#1530] Implemented retries for Driver connection refused negative cases
• Simplified elements manipulation to speed up the execution as much as possible:
  • [#1571][#1540][#1536][#1524][#1523][#1370]
• Documentation updates:
  • [#1577][#1570][#1547][#1546][#1511]
• Removed deprecated code:
  • [#1543] Removed carina-jenkins submodule
  • [#1542] Removed deprecated SpecialKeywords.QTEST_PROJECT_ID_OLD
  • [#1541] Removed deprecated timer and iPerformance operation from Carina
  • [#1496] Deleted the deprecated TestRail vars
  • [#1491] Removed the deprecated TestRail related artifacts in SpecialKeywords
• Carina Archetype updates:
  • [#1576] Archetype: removed unused Spring Framework dependencies
  • [#1560] Bumped up the archetype to use 2.17.1 log4j2x
• [#1573] Remove the "default" driver name capability registration
• [#1565] Migrated the carina-soap sample repo to Java 11
• [#1556] Track as label git_hash instead of git-commit
• [#1552] Deprecated IDriverPool.getDefaultDevice()
• [#1492] Made 'Unable to capture screenshot during ...sec!' a WARNING
• [#1453] Deployed carina snapshots to the zebrunner_snapshots repo

Fixes

• [#1545] Webdriver can't start from android emulator
• [#1534] Unable to create/initialize driver with BrowserMobProxy which was added to the capability
• [#1488] Fixed extra report folders creation

Known Issues

• N/A

Dependencies Updates

• io.netty.netty-all 4.1.42->4.1.73

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.3.15
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 1.9+

Recommendations

In 7.3.15, we split the click method for: click(..), clickByJs(..) and clickByActions(..). So suspect some regressions while clicking on hidden and unavailable elements. Please inspect such cases on your own and reuse the appropriate click explicitly if it is not a defect.

Enhancements

• Migrated to Zebrunner Agent 1.6.6

Fixes

• [#1533] Unable to assign TestRail labels onto the test run

Known Issues

• N/A

Dependencies Updates

• Zebrunner TestNG Agent 1.6.5 -> 1.6.6

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.2.14
• Update in your project pom.xml com.zebrunner.agent-core version to 1.6.6
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 1.9+

Enhancements

• [#1512] Migrated to Zebrunner Agent 1.6.5
• [#1509] Changed the copyright license header in every class
• [#1507] Restored unit testing coverage using jacoco

Fixes

• [#1514] Unable to execute the test classes from maven command line
• [#1494][#1495] Fixes to manipulate chrome experimental options in capabilities

Known Issues

• N/A

Dependencies Updates

• Zebrunner TestNG Agent 1.6.3 -> 1.6.5

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.2.13
• Update in your project pom.xml com.zebrunner.agent-core version to 1.6.5
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 1.9+

Enhancements

• [#1482] Migrated to TestNG 7.4.0
• [#1489] Registered extra labels in reporting branch and sha if available
• [#1480][#1484][#1492] Docs and logs updates

Fixes

• [#1478] platformVersion appium capability should be provided as a string
• [#1438] Deadlock was fixed for multi-threading getBaseDir calls

Known Issues

• N/A

Dependencies Updates

• TestNG 7.3.0 -> 7.4.0
• Zebrunner TestNG Agent 1.6.2 -> 1.6.3

Migration Steps

• Update in your project pom.xml version for carina-core dependency to 7.2.12
• Update in your project pom.xml com.zebrunner.agent-core version to 1.6.3
• Rebuild the project mvn -U clean compile install
• Be sure to use with Zebrunner CE 1.9+