2025-03-14 21:59:59 -06:00
|
|
|
# ctest
|
|
|
|
|
|
|
|
|
|
> CMake test driver program.
|
2026-02-18 06:55:01 -07:00
|
|
|
> More information: <https://gitlab.kitware.com/cmake/community/-/wikis/doc/ctest/Testing-With-CTest>.
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2026-06-12 17:51:25 -06:00
|
|
|
- Run all tests in the current CMake build directory:
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2026-06-12 17:51:25 -06:00
|
|
|
`ctest`
|
|
|
|
|
|
|
|
|
|
- Run all tests defined in the CMake build directory, executing 4 [j]obs at a time in parallel:
|
|
|
|
|
|
|
|
|
|
`ctest {{[-j|--parallel]}} 4`
|
|
|
|
|
|
|
|
|
|
- Run all tests defined in the CMake build directory and print detailed logs on failed tests:
|
|
|
|
|
|
|
|
|
|
`ctest --output-on-failure`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- List available tests:
|
|
|
|
|
|
2025-05-08 12:26:01 -06:00
|
|
|
`ctest {{[-N|--show-only]}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-09-14 18:48:49 -06:00
|
|
|
- Run a single test based on its name, or filter on a `regex`:
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-05-08 12:26:01 -06:00
|
|
|
`ctest --output-on-failure {{[-R|--tests-regex]}} '^{{test_name}}$'`
|
