Skip to content

Releases

Catch3 0.4.0

Choose a tag to compare

@Leitwolf11 Leitwolf11 released this 15 Nov 12:29
8979c1c

Released 2026-11-15.

Versions of Catch3 have three numbers again from this release on:
MAJOR.MINOR.PATCH, as Semantic Versioning writes them.

The Catch3 runner

  • --coverage=DIR runs every test in a process of its own and keeps what each
    one reached: DIR/coverage.json maps every test to the lines it ran, and
    DIR/coverage.lcov is the run combined. It reads LLVM source-based coverage
    (Clang) and gcov (GCC). See Per-test coverage.
  • Workers and the processes the runner starts no longer inherit the variables
    whose names look like secrets (TOKEN, SECRET, PASSWORD and the like).
    --pass-env=NAME, which can be repeated, or "pass-env" in the project
    configuration hands one to the tests that need it.
    See Environment variables.

Tools

  • The repository tools are C++17 and run through Bazel:
    //tools:check, //tools:amalgamate, //tools:version,
    //tools:release_notes, //tools:repo_info and //tools:third_party.
    They replace the Python scripts of earlier releases.

Catch3 0.3.0.2

Choose a tag to compare

@Leitwolf11 Leitwolf11 released this 01 Nov 21:36
13324a0

Released 2026-11-01.

Mocks

  • <Progmasoft/Catch3/Mock.hpp> adds mocks of virtual interfaces and of free
    functions behind a seam: CATCH3_MOCK_METHOD, CATCH3_EXPECT_CALL,
    Sequence and ScopedSeam. Expectations check call counts, arguments and
    order, and failures go through the same assertions as the rest of a test.
    See Mocking.

Catch3 0.3.0.1

Choose a tag to compare

@Leitwolf11 Leitwolf11 released this 01 Nov 16:05
26a1588

Released 2026-11-01.

Versions of Catch3 have four numbers from this release on.

The Catch3 runner

  • --import=FILE reads the reports of other test frameworks instead of running
    tests: JUnit, xUnit, TRX, TAP, CTRF, Catch3's own, and a small JSON Lines
    format for anything else. Their tests get the history, flaky detection,
    quarantine, analytics and reports of a run.

Catch3 0.3.0

Choose a tag to compare

@Leitwolf11 Leitwolf11 released this 01 Nov 09:34
1559307

Released 2026-11-01.

Tags of Catch3 are catch3-<version> from this release on.

Language and license

Catch3 is C++17, and its headers work in C++17 and later. Progmasoft-authored
files move to the Progmasoft Linking Exception, Version 2.0; Catch2-derived code
keeps the Boost Software License.

The Catch3 runner

Catch3 keeps Catch2's API for writing tests and replaces its session, command
line and reporters with a runner of its own:

  • Tests run in parallel worker processes; a crash, an exit or a hang ends one
    test, not the run.
  • Failures are retried alone to tell deterministic, flaky and order-dependent
    failures apart; the test that leaves state behind is found by bisection.
  • A history of verdicts and durations drives quarantine, learned time limits,
    predictive ordering, incremental runs, replay and analytics.
  • Tests are selected by change, by past failure or by prediction, and sharded
    by a stable hash or by recorded duration.
  • Tags declare serial and isolated tests, shared resources, dependencies,
    time limits and retries.
  • Every failure gets a category, a signature, an analysis and a replay command.
  • Reports are console, JUnit XML, JSON and a Chrome trace; --list=json is a
    versioned discovery format.
  • Every test gets a temporary directory of its own.
  • A project keeps its options in a
    catch3.json, found up to
    the root of the repository; the command line wins over it, and
    --config=FILE and --no-config choose another file or none.
  • JSON is read and written with yyjson
    and JUnit XML is written with pugixml,
    both MIT and vendored in third_party/. They are compiled into Catch3's
    own translation units with internal linkage or a renamed namespace, so a
    project that links its own copy of either library is not affected. The
    amalgamated sources include them from a third file,
    extras/catch_amalgamated_third_party.hpp.

Breaking changes

  • Catch3 has its own build and header names, so that it is never mistaken
    for Catch2 and both can be used in one project:
    • CMake: find_package(Catch3) with Catch3::Catch3 and
      Catch3::Catch3WithMain, options CATCH3_*, and the scripts
      Catch3.cmake (catch3_discover_tests) and Catch3ShardTests.cmake
      (catch3_add_sharded_tests). The Progmasoft::Catch3 target is gone:
      its code is part of Catch3::Catch3.
    • Bazel //:catch3 and //:catch3_main, Meson catch3 and
      catch3-with-main, pkg-config catch3.pc and catch3-with-main.pc.
    • Headers moved from catch2/ to Progmasoft/Catch3/ with Progmasoft
      names: <catch2/catch_test_macros.hpp> is
      <Progmasoft/Catch3/TestMacros.hpp>, <catch2/matchers/catch_matchers_string.hpp>
      is <Progmasoft/Catch3/Matchers/String.hpp>, and so on. Test bodies do
      not change: the macros and the Catch:: namespace keep their names.
    • ParseAndAddCatchTests.cmake, deprecated upstream, was removed.
  • Catch2's command line, reporters, CATCH_REGISTER_REPORTER and listing
    were removed; see the command line and
    reports. Listeners keep working.
  • C++17 is the minimum, for the library and for the code that uses it.
  • The results model in Progmasoft/Catch3/Results.hpp was rewritten around
    tests and attempts.
  • Conan packaging was dropped.

Fixes

  • The property engine's example database can be written by several
    processes at once.

Progmasoft Catch3 0.2.0

Choose a tag to compare

@Leitwolf11 Leitwolf11 released this 24 Sep 20:06

Adds compiled snapshot and result-reporting support. This release introduces opt-in snapshot comparison/update APIs, framework-neutral test result summaries, and deterministic JUnit-style XML serialization. The Progmasoft utilities are built as a static library across the supported build systems; Catch2's existing compatibility engine remains unchanged.

Progmasoft Catch3 0.1.0

Choose a tag to compare

@Leitwolf11 Leitwolf11 released this 24 Sep 19:07

Initial release of Progmasoft's Catch2-compatible property-testing extension. The existing Catch2 engine remains the compatibility foundation; this release adds a separate deterministic property-testing API, Bazel module metadata, and alternate CMake, Meson, Xmake, and Premake builds.