[{"data":1,"prerenderedAt":290},["ShallowReactive",2],{"doc-why-catch3":3},{"id":4,"title":5,"body":6,"description":16,"extension":281,"meta":282,"navigation":283,"path":284,"seo":285,"slug":286,"source":287,"stem":288,"__hash__":289},"docs\u002Fdocs\u002Fwhy-catch3.md","Why Progmasoft Catch3?",{"type":7,"value":8,"toc":273},"minimark",[9,13,17,31,36,222,230,234,245,248,252,255,259,267],[10,11,5],"h1",{"id":12},"why-progmasoft-catch3",[14,15,16],"p",{},"Progmasoft Catch3 is an independently maintained continuation built on the\nCatch2 v3 codebase. It exists to preserve Catch2's practical testing model while\ngiving Progmasoft room to add capabilities and APIs under a clear ownership,\nnamespace, build-target, and licensing boundary.",[14,18,19,20,24,25,30],{},"The name does ",[21,22,23],"strong",{},"not"," mean that this is an official Catch2 v3 release, a new\nupstream version, or a project endorsed by Catch2's maintainers. The current\ncompatibility engine is based on Catch2's 3.16.1 development line. The project\nis still early-stage. It keeps Catch2's API for writing tests and replaced\nCatch2's runner with ",[26,27,29],"a",{"href":28},"\u002Fdocs\u002Fprogmasoft-runner\u002F","its own",".",[32,33,35],"h2",{"id":34},"what-is-different-today","What is different today?",[37,38,39,55],"table",{},[40,41,42],"thead",{},[43,44,45,49,52],"tr",{},[46,47,48],"th",{},"Area",[46,50,51],{},"Catch2 compatibility engine",[46,53,54],{},"Progmasoft Catch3 additions",[56,57,58,83,107,118,129,159,182,211],"tbody",{},[43,59,60,64,72],{},[61,62,63],"td",{},"Test execution",[61,65,66,67,71],{},"Catch2's test registration, ",[68,69,70],"code",{},"RunContext"," and listeners",[61,73,74,75,78,79,82],{},"The Catch3 runner: parallel worker processes, retries, flaky-test detection, quarantine, history, selection, sharding and its own command line and reports; ",[68,76,77],{},"CATCH3_CHECK_FOR_ALL"," and ",[68,80,81],{},"CATCH3_CHECK_PROPERTY"," report property outcomes through Catch2's assertion path",[43,84,85,88,98],{},[61,86,87],{},"Public include path",[61,89,90,91,94,95],{},"The engine's headers moved to ",[68,92,93],{},"Progmasoft\u002FCatch3\u002F..."," with Progmasoft names, such as ",[68,96,97],{},"TestMacros.hpp",[61,99,100,103,104,106],{},[68,101,102],{},"Progmasoft\u002FCatch3.hpp"," and the other ",[68,105,93],{}," headers",[43,108,109,112,115],{},[61,110,111],{},"C++ baseline",[61,113,114],{},"C++17; the headers work in C++17 and later",[61,116,117],{},"The same",[43,119,120,123,126],{},[61,121,122],{},"Randomness",[61,124,125],{},"Catch2's existing behavior is unchanged",[61,127,128],{},"A specified SplitMix64 sequence provides deterministic trial seeds and unbiased bounded integer sampling",[43,130,131,134,137],{},[61,132,133],{},"Generated values",[61,135,136],{},"No change to existing Catch2 generators",[61,138,139,140,143,144,78,147,150,151,154,155,158],{},"Strategies for numbers, text, collections and structures with ",[68,141,142],{},"Map",", ",[68,145,146],{},"Filter",[68,148,149],{},"FlatMap","; shrinking of recorded choices, so every combination shrinks; replay tokens and an example database; state machines, ",[68,152,153],{},"Classify","\u002F",[68,156,157],{},"Cover"," statistics, targeted search, and differential and metamorphic oracles",[43,160,161,164,167],{},[61,162,163],{},"Mocks",[61,165,166],{},"None",[61,168,169,78,178,181],{},[26,170,172,143,175],{"href":171},"\u002Fdocs\u002Fprogmasoft-mocking\u002F",[68,173,174],{},"CATCH3_MOCK_METHOD",[68,176,177],{},"CATCH3_EXPECT_CALL",[68,179,180],{},"Sequence",", reporting through the assertion path",[43,183,184,187,208],{},[61,185,186],{},"Build identity",[61,188,189,190,193,194,78,197,143,200,203,204,207],{},"One library: the ",[68,191,192],{},"Catch3"," CMake package with ",[68,195,196],{},"Catch3::Catch3",[68,198,199],{},"Catch3::Catch3WithMain",[68,201,202],{},"\u002F\u002F:catch3"," in Bazel, ",[68,205,206],{},"catch3"," in Meson and pkg-config",[61,209,210],{},"The same library",[43,212,213,216,219],{},[61,214,215],{},"Source terms",[61,217,218],{},"Catch2-originated source retains its upstream BSL-1.0 terms",[61,220,221],{},"Progmasoft-authored additions state their own SPDX license in each file",[14,223,224,225,229],{},"Properties take any number of generated values. Shrinking is deterministic and\nbounded, but local rather than globally minimal. Parallel trials do not\nexist yet; ",[26,226,228],{"href":227},"\u002Fdocs\u002Fprogmasoft-roadmap\u002F","the roadmap","\norders them with per-test coverage, test selection, mutation testing\nand test generation.",[32,231,233],{"id":232},"compatibility-policy","Compatibility policy",[14,235,236,237,240,241,244],{},"Catch2's macros and its ",[68,238,239],{},"Catch"," namespace, with matchers, generators and\nlisteners, remain the compatibility surface. The runner, its command line,\nits reports, the header paths and the build names are Catch3's own; moving\ntests from Catch2 means changing their includes and their build files, not\ntheir bodies. Progmasoft features are added in ",[68,242,243],{},"Progmasoft::Catch3"," and must\nnot require users to rewrite existing Catch2 test bodies. The first compatibility goal is source-level\ncontinuity with the included Catch2 3.16.1 base; this is not a promise that every\nfuture Catch2 upstream change will be adopted unchanged or that all downstream\nprojects have already been validated.",[14,246,247],{},"The engine, the runner and the Progmasoft additions are one compiled C++17\nlibrary. Template-based generators and call-site assertion macros remain in\nheaders; snapshot I\u002FO, result aggregation, and XML serialization are compiled\nimplementations.\nKeep tests for the two areas independently identifiable so additions do not\nsilently alter the upstream compatibility baseline.",[32,249,251],{"id":250},"why-a-fork-instead-of-a-patch-series","Why a fork instead of a patch series?",[14,253,254],{},"The initial additions need their own design and release cycle. Keeping them in a\nseparate namespace and file tree lets the project prototype those APIs without\npresenting them as upstream Catch2 behavior. If a change is later proposed to\nCatch2 upstream, prepare it as a separate contribution under Catch2's current\ncontribution and licensing requirements; do not assume Progmasoft-licensed\nfiles can be submitted unchanged.",[32,256,258],{"id":257},"build-system-support","Build-system support",[14,260,261,262,78,264,266],{},"Bazel is the primary build and validation path. CMake, Meson, Xmake, and Premake\nare supported alternate project-generation\u002Fbuild paths over the same local sources.\nThe CMake project exports ",[68,263,196],{},[68,265,199],{},"; the\nother build descriptions compile the same library and the Progmasoft\nproperty-test executable. See the repository build\ninstructions and each build file for tool-specific commands.",[14,268,269,270,272],{},"Registry publication is a separate release step. It requires a versioned\nimmutable source archive and successful validation and maintainer review for\nthe ",[68,271,206],{}," module name; a submission is not a guarantee of acceptance.",{"title":274,"searchDepth":275,"depth":275,"links":276},"",2,[277,278,279,280],{"id":34,"depth":275,"text":35},{"id":232,"depth":275,"text":233},{"id":250,"depth":275,"text":251},{"id":257,"depth":275,"text":258},"md",{},true,"\u002Fdocs\u002Fwhy-catch3",{"title":5,"description":16},"why-catch3","docs\u002Fwhy-catch3.md","docs\u002Fwhy-catch3","cDlZwujgWSqoFpRkP8V10FzIdzos5nd0mW6dVggZKwc",1794961595575]