onqtam/doctest
Doctest
doctest is a unit testing framework and assertion library for C++ delivered as a single-header library. It provides a test runner with a command line interface to execute tests, filter test suites, and generate execution reports.
The framework supports in-source unit testing and allows for the complete removal of testing logic from compiled binaries via preprocessor stripping to eliminate performance overhead in production environments. It also enables cross-binary test registry sharing, allowing one executable to utilize the test runner of another.
Capabilities include parameterized testing, thread-safe assertion verification for concurrent software validation, and automated test reporting for regression analysis. It utilizes automatic test registration to collect test cases without requiring manual lists of functions to execute.
Features
- Unit Testing Frameworks - Provides a comprehensive framework for writing and executing isolated unit tests to verify C++ logic.
- Thread-Safe Assertions - Implements thread-safe assertion verification to validate shared data consistency in concurrent software.
- Testing Logic Stripping - Allows the complete removal of testing logic from compiled binaries via preprocessor stripping for production environments.
- Production Logic Exclusion - Provides a mechanism to remove all testing logic from the compiled executable to eliminate production performance overhead.
- Header-Only Libraries - Delivered as a single-header library to simplify integration and eliminate separate compilation steps.
- Production Build Modes - Optimizes production builds by disabling development-only debugging and testing features.
- Test Execution Controls - Provides controls for executing specific test suites and defining their behavior via the command line.
- Assertion and Validation Utilities - Implements a system to define test conditions and assertions that report failures when expectations are not met.
- Assertion Libraries - Ships a set of assertion macros to validate code conditions and verify invariants during test execution.
- Test Execution Runners - Provides a command-line interface to manage the lifecycle, filtering, and execution of registered test suites.
- Thread-Safe Assertion Recording - Implements internal locking mechanisms to safely record and report test failures occurring across multiple concurrent threads.
- Static Registration - Implements static registration to collect test cases into registries at compile time using preprocessor macros.
- Concurrent Assertion Validation - Enables checking conditions across multiple threads to ensure shared data remains consistent and safe.
- Test Result Reporters - Generates detailed summaries of test execution results to analyze passed and failed cases.
- Test Parameterization - Provides utilities to execute the same test logic across multiple sets of input data.
- In-Source Testing - Allows the creation and execution of test cases and assertions directly within the C++ source files.
- Regression Testing Suites - Supports executing parameterized test cases across multiple input sets to prevent software regressions.
- Expression Decomposition - Employs C++ templates to decompose expressions into strings for detailed error reporting upon assertion failure.
- Cross-Binary Registry Sharing - Enables cross-binary test registry sharing, allowing one executable to utilize the test runner of another.
- Testing and Benchmarking - Lightweight single-header testing framework.
- Testing and Debugging - Lightweight, feature-rich single-header testing framework.
- Testing Frameworks - Offers a fast, header-only C++ testing framework.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
