[{"data":1,"prerenderedAt":533},["ShallowReactive",2],{"doc-changelog":3},{"id":4,"title":5,"body":6,"description":523,"extension":524,"meta":525,"navigation":526,"path":527,"seo":528,"slug":529,"source":530,"stem":531,"__hash__":532},"docs\u002Fdocs\u002Fchangelog.md","Release notes",{"type":7,"value":8,"toc":500},"minimark",[9,13,25,70,74,77,85,90,138,142,168,171,174,178,203,206,208,211,214,222,225,227,234,238,241,244,252,321,325,461,465,470,473,476,487,490,492],[10,11,5],"h1",{"id":12},"release-notes",[14,15,16,17,24],"p",{},"These are the releases of Progmasoft Catch3. Its compatibility engine is\nbased on Catch2 3.16.1; Catch2's own history is in\n",[18,19,23],"a",{"href":20,"rel":21},"https:\u002F\u002Fgithub.com\u002Fcatchorg\u002FCatch2\u002Fblob\u002Fdevel\u002Fdocs\u002Frelease-notes.md",[22],"nofollow","its release notes",".",[14,26,27,31,34,38,40,44,46,50,52,56,58,62,64,68],{},[28,29,30],"strong",{},"Contents",[32,33],"br",{},[18,35,37],{"href":36},"#040","0.4.0",[32,39],{},[18,41,43],{"href":42},"#0302","0.3.0.2",[32,45],{},[18,47,49],{"href":48},"#0301","0.3.0.1",[32,51],{},[18,53,55],{"href":54},"#030","0.3.0",[32,57],{},[18,59,61],{"href":60},"#020","0.2.0",[32,63],{},[18,65,67],{"href":66},"#010","0.1.0",[32,69],{},[71,72,37],"h2",{"id":73},"_040",[14,75,76],{},"Released 2026-11-15.",[14,78,79,80,84],{},"Versions of Catch3 have three numbers again from this release on:\n",[81,82,83],"code",{},"MAJOR.MINOR.PATCH",", as Semantic Versioning writes them.",[86,87,89],"h3",{"id":88},"the-catch3-runner","The Catch3 runner",[91,92,93,112],"ul",{},[94,95,96,99,100,103,104,107,108,24],"li",{},[81,97,98],{},"--coverage=DIR"," runs every test in a process of its own and keeps what each\none reached: ",[81,101,102],{},"DIR\u002Fcoverage.json"," maps every test to the lines it ran, and\n",[81,105,106],{},"DIR\u002Fcoverage.lcov"," is the run combined. It reads LLVM source-based coverage\n(Clang) and gcov (GCC). See ",[18,109,111],{"href":110},"\u002Fdocs\u002Fprogmasoft-runner\u002F#per-test-coverage","Per-test coverage",[94,113,114,115,118,119,118,122,125,126,129,130,133,134,24],{},"Workers and the processes the runner starts no longer inherit the variables\nwhose names look like secrets (",[81,116,117],{},"TOKEN",", ",[81,120,121],{},"SECRET",[81,123,124],{},"PASSWORD"," and the like).\n",[81,127,128],{},"--pass-env=NAME",", which can be repeated, or ",[81,131,132],{},"\"pass-env\""," in the project\nconfiguration hands one to the tests that need it.\nSee ",[18,135,137],{"href":136},"\u002Fdocs\u002Fprogmasoft-runner\u002F#environment-variables","Environment variables",[86,139,141],{"id":140},"tools","Tools",[91,143,144],{},[94,145,146,147,118,150,118,153,156,157,118,160,163,164,167],{},"The repository tools are C++17 and run through Bazel:\n",[81,148,149],{},"\u002F\u002Ftools:check",[81,151,152],{},"\u002F\u002Ftools:amalgamate",[81,154,155],{},"\u002F\u002Ftools:version",",\n",[81,158,159],{},"\u002F\u002Ftools:release_notes",[81,161,162],{},"\u002F\u002Ftools:repo_info"," and ",[81,165,166],{},"\u002F\u002Ftools:third_party",".\nThey replace the Python scripts of earlier releases.",[71,169,43],{"id":170},"_0302",[14,172,173],{},"Released 2026-11-01.",[86,175,177],{"id":176},"mocks","Mocks",[91,179,180],{},[94,181,182,185,186,118,189,156,192,163,195,198,199,24],{},[81,183,184],{},"\u003CProgmasoft\u002FCatch3\u002FMock.hpp>"," adds mocks of virtual interfaces and of free\nfunctions behind a seam: ",[81,187,188],{},"CATCH3_MOCK_METHOD",[81,190,191],{},"CATCH3_EXPECT_CALL",[81,193,194],{},"Sequence",[81,196,197],{},"ScopedSeam",". Expectations check call counts, arguments and\norder, and failures go through the same assertions as the rest of a test.\nSee ",[18,200,202],{"href":201},"\u002Fdocs\u002Fprogmasoft-mocking\u002F","Mocking",[71,204,49],{"id":205},"_0301",[14,207,173],{},[14,209,210],{},"Versions of Catch3 have four numbers from this release on.",[86,212,89],{"id":213},"the-catch3-runner-1",[91,215,216],{},[94,217,218,221],{},[81,219,220],{},"--import=FILE"," reads the reports of other test frameworks instead of running\ntests: JUnit, xUnit, TRX, TAP, CTRF, Catch3's own, and a small JSON Lines\nformat for anything else. Their tests get the history, flaky detection,\nquarantine, analytics and reports of a run.",[71,223,55],{"id":224},"_030",[14,226,173],{},[14,228,229,230,233],{},"Tags of Catch3 are ",[81,231,232],{},"catch3-\u003Cversion>"," from this release on.",[86,235,237],{"id":236},"language-and-license","Language and license",[14,239,240],{},"Catch3 is C++17, and its headers work in C++17 and later. Progmasoft-authored\nfiles move to the Progmasoft Linking Exception, Version 2.0; Catch2-derived code\nkeeps the Boost Software License.",[86,242,89],{"id":243},"the-catch3-runner-2",[14,245,246,247,251],{},"Catch3 keeps Catch2's API for writing tests and replaces its session, command\nline and reporters with ",[18,248,250],{"href":249},"\u002Fdocs\u002Fprogmasoft-runner\u002F","a runner of its own",":",[91,253,254,257,260,263,266,269,272,279,282,299],{},[94,255,256],{},"Tests run in parallel worker processes; a crash, an exit or a hang ends one\ntest, not the run.",[94,258,259],{},"Failures are retried alone to tell deterministic, flaky and order-dependent\nfailures apart; the test that leaves state behind is found by bisection.",[94,261,262],{},"A history of verdicts and durations drives quarantine, learned time limits,\npredictive ordering, incremental runs, replay and analytics.",[94,264,265],{},"Tests are selected by change, by past failure or by prediction, and sharded\nby a stable hash or by recorded duration.",[94,267,268],{},"Tags declare serial and isolated tests, shared resources, dependencies,\ntime limits and retries.",[94,270,271],{},"Every failure gets a category, a signature, an analysis and a replay command.",[94,273,274,275,278],{},"Reports are console, JUnit XML, JSON and a Chrome trace; ",[81,276,277],{},"--list=json"," is a\nversioned discovery format.",[94,280,281],{},"Every test gets a temporary directory of its own.",[94,283,284,285,291,292,163,295,298],{},"A project keeps its options in a\n",[18,286,288],{"href":287},"\u002Fdocs\u002Fprogmasoft-runner\u002F#project-configuration",[81,289,290],{},"catch3.json",", found up to\nthe root of the repository; the command line wins over it, and\n",[81,293,294],{},"--config=FILE",[81,296,297],{},"--no-config"," choose another file or none.",[94,300,301,302,307,308,313,314,317,318,24],{},"JSON is read and written with ",[18,303,306],{"href":304,"rel":305},"https:\u002F\u002Fgithub.com\u002Fibireme\u002Fyyjson",[22],"yyjson","\nand JUnit XML is written with ",[18,309,312],{"href":310,"rel":311},"https:\u002F\u002Fgithub.com\u002Fzeux\u002Fpugixml",[22],"pugixml",",\nboth MIT and vendored in ",[81,315,316],{},"third_party\u002F",". They are compiled into Catch3's\nown translation units with internal linkage or a renamed namespace, so a\nproject that links its own copy of either library is not affected. The\namalgamated sources include them from a third file,\n",[81,319,320],{},"extras\u002Fcatch_amalgamated_third_party.hpp",[86,322,324],{"id":323},"breaking-changes","Breaking changes",[91,326,327,432,448,451,458],{},[94,328,329,330],{},"Catch3 has its own build and header names, so that it is never mistaken\nfor Catch2 and both can be used in one project:\n",[91,331,332,373,396,426],{},[94,333,334,335,338,339,342,343,346,347,350,351,354,355,358,359,362,363,366,367,370,371,24],{},"CMake: ",[81,336,337],{},"find_package(Catch3)"," with ",[81,340,341],{},"Catch3::Catch3"," and\n",[81,344,345],{},"Catch3::Catch3WithMain",", options ",[81,348,349],{},"CATCH3_*",", and the scripts\n",[81,352,353],{},"Catch3.cmake"," (",[81,356,357],{},"catch3_discover_tests",") and ",[81,360,361],{},"Catch3ShardTests.cmake","\n(",[81,364,365],{},"catch3_add_sharded_tests","). The ",[81,368,369],{},"Progmasoft::Catch3"," target is gone:\nits code is part of ",[81,372,341],{},[94,374,375,376,163,379,382,383,342,386,389,390,163,393,24],{},"Bazel ",[81,377,378],{},"\u002F\u002F:catch3",[81,380,381],{},"\u002F\u002F:catch3_main",", Meson ",[81,384,385],{},"catch3",[81,387,388],{},"catch3-with-main",", pkg-config ",[81,391,392],{},"catch3.pc",[81,394,395],{},"catch3-with-main.pc",[94,397,398,399,402,403,406,407,410,411,118,414,417,418,421,422,425],{},"Headers moved from ",[81,400,401],{},"catch2\u002F"," to ",[81,404,405],{},"Progmasoft\u002FCatch3\u002F"," with Progmasoft\nnames: ",[81,408,409],{},"\u003Ccatch2\u002Fcatch_test_macros.hpp>"," is\n",[81,412,413],{},"\u003CProgmasoft\u002FCatch3\u002FTestMacros.hpp>",[81,415,416],{},"\u003Ccatch2\u002Fmatchers\u002Fcatch_matchers_string.hpp>","\nis ",[81,419,420],{},"\u003CProgmasoft\u002FCatch3\u002FMatchers\u002FString.hpp>",", and so on. Test bodies do\nnot change: the macros and the ",[81,423,424],{},"Catch::"," namespace keep their names.",[94,427,428,431],{},[81,429,430],{},"ParseAndAddCatchTests.cmake",", deprecated upstream, was removed.",[94,433,434,435,438,439,342,443,447],{},"Catch2's command line, reporters, ",[81,436,437],{},"CATCH_REGISTER_REPORTER"," and listing\nwere removed; see ",[18,440,442],{"href":441},"\u002Fdocs\u002Fcommand-line\u002F","the command line",[18,444,446],{"href":445},"\u002Fdocs\u002Freporters\u002F","reports",". Listeners keep working.",[94,449,450],{},"C++17 is the minimum, for the library and for the code that uses it.",[94,452,453,454,457],{},"The results model in ",[81,455,456],{},"Progmasoft\u002FCatch3\u002FResults.hpp"," was rewritten around\ntests and attempts.",[94,459,460],{},"Conan packaging was dropped.",[86,462,464],{"id":463},"fixes","Fixes",[91,466,467],{},[94,468,469],{},"The property engine's example database can be written by several\nprocesses at once.",[71,471,61],{"id":472},"_020",[14,474,475],{},"Released 2026-09-24.",[91,477,478,481,484],{},[94,479,480],{},"Snapshot comparison and update APIs.",[94,482,483],{},"Framework-neutral test result summaries and deterministic JUnit XML.",[94,485,486],{},"The Progmasoft additions are a static library in every supported build\nsystem.",[71,488,67],{"id":489},"_010",[14,491,475],{},[91,493,494,497],{},[94,495,496],{},"The first release: a deterministic property-testing API next to the\nCatch2-compatible engine.",[94,498,499],{},"Bazel module metadata, and CMake, Meson, Xmake and Premake builds.",{"title":501,"searchDepth":502,"depth":502,"links":503},"",2,[504,509,512,515,521,522],{"id":73,"depth":502,"text":37,"children":505},[506,508],{"id":88,"depth":507,"text":89},3,{"id":140,"depth":507,"text":141},{"id":170,"depth":502,"text":43,"children":510},[511],{"id":176,"depth":507,"text":177},{"id":205,"depth":502,"text":49,"children":513},[514],{"id":213,"depth":507,"text":89},{"id":224,"depth":502,"text":55,"children":516},[517,518,519,520],{"id":236,"depth":507,"text":237},{"id":243,"depth":507,"text":89},{"id":323,"depth":507,"text":324},{"id":463,"depth":507,"text":464},{"id":472,"depth":502,"text":61},{"id":489,"depth":502,"text":67},"These are the releases of Progmasoft Catch3. Its compatibility engine is\nbased on Catch2 3.16.1; Catch2's own history is in\nits release notes.","md",{},true,"\u002Fdocs\u002Fchangelog",{"title":5,"description":523},"changelog","docs\u002Frelease-notes.md","docs\u002Fchangelog","ZIRsebrSWkPAiZQlaAL1Hk0XWH95tgKXQpbEhSrieAE",1794961594552]