andrew/libakerror
1
0
Fork 0
Code Issues 9 Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Pass CMake arguments to mutation builds
All checks were successful
libakerror CI Build / cmake_build (push) Successful in 2m51s
Details
libakerror CI Build / cmake_build_freestanding (push) Successful in 2m39s
Details
libakerror CI Build / sanitizer (push) Successful in 2m59s
Details
libakerror CI Build / coverage (push) Successful in 2m49s
Details
libakerror CI Build / mutation_test (push) Successful in 47m20s
Details

Browse Source
This commit is contained in:
Logikoma
2026-08-05 13:42:12 -04:00
committed by Andrew Kesterson
parent f029957835
commit 6670837643
2 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
tests/MUTATION.md
View File

@@ -32,6 +32,9 @@ scripts/mutation_test.py --target src/error.c --list
# Gate CI: exit non-zero if the score drops below 90%
scripts/mutation_test.py --threshold 90
# Check concurrency mutants under ThreadSanitizer
scripts/mutation_test.py --cmake-arg=-DAKERR_SANITIZE=thread
```
Via CMake (configures a build first if needed):
@@ -40,8 +43,10 @@ Via CMake (configures a build first if needed):
cmake --build build --target mutation
```
Useful flags: `--timeout SECONDS` (per-suite build+test cap; a mutant that
hangs is counted as killed), `--keep` (retain the scratch copy for debugging),
Useful flags: `--cmake-arg ARG` (pass a CMake configure argument to every
mutant build; repeat it for multiple arguments), `--timeout SECONDS` (per-suite
build+test cap; a mutant that hangs is counted as killed), `--keep` (retain the
scratch copy for debugging),
`--work DIR` (use a specific scratch directory), `--junit FILE` (write a JUnit
XML report — surviving mutants appear as failing test cases).