catch3/docs/cmake-integration.md, branch v3.15.3

Document that DISCOVERY_MODE PRE_TEST should be used with catch_discover_tests when used with XCode.

2026-07-22T18:50:17+00:00

This addresses https://github.com/catchorg/Catch2/issues/2411 by making the "workaround" the official approach and is consistent with how gtest and cmake deal with the same situation.

Use latest release in docs

2025-06-15T19:05:41+00:00

Downgrade required CMake to 3.16

2025-01-05T22:45:00+00:00

We still want to build VS 2017 through AppVeyor, and those images
have CMake 3.16.2 installed. We could install newer CMake as part
of the build, but since we don't use newer CMake features yet, this
is simpler.

Support adding test tags as CTest labels in catch_discover_tests

2025-01-05T19:02:00+00:00

We also bump the minimum CMake version to 3.20 as per #2943

TEST_CASE_PERSISTENT_FIXTURE: A new fixture macro for allowing persistent fixtures throughout a TEST_CASE (#2885)

2024-08-05T15:01:41+00:00

This PR introduces a new `TEST_CASE` macro called `TEST_CASE_PERSISTENT_FIXTURE`. `TEST_CASE_PERSISTENT_FIXTURE` offers the same functionality as `TEST_CASE_METHOD` except for one difference. The object on which the test method is invoked is only created once for all invocations of the test case. The object is created just after the `testCaseStarting` event is broadcast and the object is destroyed just before the `testCaseEnding` event is broadcast.

The main motivation for this new functionality is to allow `TEST_CASE`s to do expensive setup and teardown once per `TEST_CASE`, without having to resort to abusing event listeners or static function variables with manual initialization.


Implements #1602

---------

Co-authored-by: Martin Hořeňovský

Update CMake build instructions for current CMake version

2024-02-19T14:02:08+00:00

Add Bazel instructions to integration docs (#2812)

2024-02-16T15:58:09+00:00


Co-authored-by: Fædon Jóhannes Sinis

Fix minor typos in documentation (#2769)

2023-12-10T21:01:13+00:00


Co-authored-by: Martin Hořeňovský

lifted suggested version

2023-11-14T16:10:31+00:00

Did this, because with 3.0.1, the files
- catch_xmlwriter.cpp
- catch_string_manip.hpp
- catch_test_case_info.hpp

were missing

This led to some obvious and some obscure compile errors when compiling
with g++ 13.2.0 (std c++17 or c++20)
One of these errors being "Elaborated-type-specifier for a scoped enum
must not use the ‘class’ keyword"

Since this is a rather bad experience and debugging it is
time-consuming, I suggest to simply boost the recommended version in the
snippet which is likely copied by new Catch2 users

Catch.cmake: Add new DISCOVERY_MODE option to catch_discover_tests

2023-04-19T21:51:42+00:00

Introducing a new DISCOVERY_MODE mode option, which provides greater
control over when catch_discover_tests perforsm test discovery.

It has two supported modes:
* POST_BUILD: The default behavior, which adds a POST_BUILD command
  to perform test discovery after the test has been built as was
  always done so far.

* PRE_TEST: New mode, which delays test discovery until test execution.
  The generated include file generates the appropriate CTest files at
  runtime and regenerates the CTest files when the executable is
  updated.
  This mode can be used in build-environments that don't allow for
  executing the linked binaries at build-time (like in a
  cross-compilation environment).

DISCOVERY_MODE can be controlled in two ways:
1. Setting the DISCOVERY_MODE when calling catch_discover_tests.

2. Setting the global CMAKE_CATCH_DISCOVER_TESTS_DISCOVERY_MODE prior
   to calling gtest_discover_tests.

Closes #2493