Catch3 documentation
Catch3 keeps Catch2's API for writing tests, runs them with its own runner and adds Progmasoft's C++17 extensions. Start with the tutorial, then read the runner, what Catch3 adds, native property testing, the roadmap and why Catch3 exists.
Every header is under Progmasoft/Catch3/, and the library is
Catch3::Catch3 (find_package(Catch3), //:catch3 in Bazel). The pages
marked as compatibility references describe the test-writing API Catch3
shares with Catch2: the macros and the Catch:: namespace. Progmasoft's own
API lives in the Progmasoft::Catch3 namespace. Catch3 is not an official
Catch2 release.
Reference
Writing tests:
- Assertion macros
- Matchers (asserting complex properties)
- Comparing floating point numbers
- Logging macros
- Test cases and sections
- Test fixtures
- Explicitly skipping, passing, and failing tests at runtime
- Reports
- Event Listeners
- Data Generators (value parameterized tests)
- Other macros
- Micro benchmarking
Fine tuning:
Running:
Odds and ends:
- Frequently Asked Questions (FAQ)
- Best practices and other tips
- CMake integration
- Tooling integration (CI, test runners, other)
- Known limitations
- Thread safety of the compatibility engine
Other: