# Deprecations and incoming changes
This page documents current deprecations and upcoming planned changes inside Catch2. The difference between these is that a deprecated feature will be removed, while a planned change to a feature means that the feature will behave differently, but will still be present. Obviously, either of these is a breaking change, and thus will not happen until at least the next major release.
ParseAndAddCatchTests.cmakeThe CMake/CTest integration using
ParseAndAddCatchTests.cmake is deprecated, as it can be
replaced by Catch.cmake that provides the function
catch_discover_tests to get tests directly from a CMake
target via the command line interface instead of parsing C++ code with
regular expressions.
CATCH_CONFIG_BAZEL_SUPPORTCatch2 supports writing the Bazel JUnit XML output file when it is
aware that is within a bazel testing environment. Originally there was
no way to accurately probe the environment for this information so the
flag CATCH_CONFIG_BAZEL_SUPPORT was added. This now
deprecated. Bazel has now had a change where it will export
BAZEL_TEST=1 for purposes like the above. Catch2 will now
instead inspect the environment instead of relying on build
configuration.
IEventLister::skipTest( TestCaseInfo const& testInfo )This event (including implementations in derived classes such as
ReporterBase) is deprecated and will be removed in the next
major release. It is currently invoked for all test cases that are not
going to be executed due to the test run being aborted (when using
--abort or --abortx). It is however
NOT invoked for test cases that are explicitly skipped using the
SKIP macro.
TEST_CASE_METHODDeprecated in Catch2 vX.Y.Z
Currently, the member function generated for
TEST_CASE_METHOD is not const qualified. In
the future, the generated member function will be const
qualified, just as TEST_CASE_PERSISTENT_FIXTURE does.
If you are mutating the fixture instance from within the test case,
and want to keep doing so in the future, mark the mutated members as
mutable.