COMMAND genhtml --title "JSON for Modern C++" --legend --demangle-cpp --output-directory html --show-details --branch-coverage json.info.filtered.noexcept
COMMENT "Generating HTML report test/html/index.html"
)
# add target to collect coverage information and generate HTML file
# (filter script from https://stackoverflow.com/a/43726240/266378)
COMMAND genhtml --title "JSON for Modern C++" --legend --demangle-cpp --output-directory html --show-details --branch-coverage json.info.filtered.noexcept
COMMENT "Generating HTML report test/html/index.html"
A massively parallel gcov wrapper for generating intermediate coverage formats *fast*
The goal of fastcov is to generate code coverage intermediate formats *as fast as possible* (ideally < 1 second), even for large projects with hundreds of gcda objects. The intermediate formats may then be consumed by a report generator such as lcov's genhtml, or a dedicated front end such as coveralls. fastcov was originally designed to be a drop-in replacement for lcov (application coverage only, not kernel coverage).
Currently the only intermediate formats supported are gcov json format and lcov info format. Adding support for other formats should require just a few lines of python to transform gcov json format to the desired shape.
In order to achieve the massive speed gains, a few constraints apply:
1. GCC version >= 9.0.0
These versions of GCOV have support for JSON intermediate format as well as streaming report data straight to stdout
2. Object files must be either be built:
- Using absolute paths for all `-I` flags passed to the compiler
- Invoking the compiler from the same root directory
If you use CMake, you are almost certainly satisfying the second constraint (unless you care about `ExternalProject` coverage).
It is possible to reap most of the benefits of fastcov for GCC version <9.0.0and>= 7.1.0. However, there will be a *potential* header file loss of correctness.
`fastcov_legacy.py` can be used with pre GCC-9 down to GCC 7.1.0 but with a few penalties due to gcov limitations. This is because running gcov in parallel generates .gcov header reports in parallel which overwrite each other. This isn't a problem unless your header files have actual logic (i.e. header only library) that you want to measure coverage for. Use the `-F` flag to specify which gcda files should not be run in parallel in order to capture accurate header file data just for those. I don't plan on supporting `fastcov_legacy.py` aside from basic bug fixes.
## Benchmarks
Anecdotal testing on my own projects indicate that fastcov is over 100x faster than lcov and over 30x faster than gcovr:
Project Size: ~250 .gcda, ~500 .gcov generated by gcov
parser=argparse.ArgumentParser(description='A parallel gcov wrapper for fast coverage report generation')
parser.add_argument('-z','--zerocounters',dest='zerocounters',action="store_true",help='Recursively delete all gcda files')
parser.add_argument('-f','--gcda-files',dest='gcda_files',nargs="+",default=[],help='Specify exactly which gcda files should be processed instead of recursivly searching the search directory.')
parser.add_argument('-E','--exclude-gcda',dest='excludepre',nargs="+",default=[],help='.gcda filter - Exclude gcda files from being processed via simple find matching (not regex)')
parser.add_argument('-e','--exclude-gcov',dest='excludepost',nargs="+",default=[],help='.gcov filter - Exclude gcov files from being processed via simple find matching (not regex)')
parser.add_argument('-g','--gcov',dest='gcov',default='gcov',help='which gcov binary to use')
parser.add_argument('-d','--search-directory',dest='directory',default=".",help='Base directory to recursively search for gcda files (default: .)')
parser.add_argument('-c','--compiler-directory',dest='cdirectory',default=".",help='Base directory compiler was invoked from (default: .)')
parser.add_argument('-j','--jobs',dest='jobs',type=int,default=multiprocessing.cpu_count(),help='Number of parallel gcov to spawn (default: %d).'%multiprocessing.cpu_count())
parser.add_argument('-o','--output',dest='output',default="coverage.json",help='Name of output file (default: coverage.json)')
parser.add_argument('-i','--lcov',dest='lcov',action="store_true",help='Output in lcov info format instead of gcov json')
parser.add_argument('-q','--quiet',dest='quiet',action="store_true",help='Suppress output to stdout')
parser=argparse.ArgumentParser(description='A parallel gcov wrapper for fast coverage report generation')
parser.add_argument('-z','--zerocounters',dest='zerocounters',action="store_true",help='Recursively delete all gcda files')
parser.add_argument('-f','--gcda-files',dest='gcda_files',nargs="+",default=[],help='Specify exactly which gcda files should be processed instead of recursivly searching the search directory.')
parser.add_argument('-F','--gcda-files-accurate',dest='gcda_files_accurate',nargs="+",default=[],help='(< gcov 9.0.0) Get accurate header coverage information for just these. These files cannot be processed in parallel')
parser.add_argument('-E','--exclude-gcda',dest='excludepre',nargs="+",default=[],help='.gcda filter - Exclude gcda files from being processed via simple find matching (not regex)')
parser.add_argument('-e','--exclude-gcov',dest='excludepost',nargs="+",default=[],help='.gcov filter - Exclude gcov files from being processed via simple find matching (not regex)')
parser.add_argument('-g','--gcov',dest='gcov',default='gcov',help='which gcov binary to use')
parser.add_argument('-d','--search-directory',dest='directory',default=".",help='Base directory to recursively search for gcda files (default: .)')
parser.add_argument('-c','--compiler-directory',dest='cdirectory',default=".",help='Base directory compiler was invoked from (default: .)')
parser.add_argument('-j','--jobs',dest='jobs',type=int,default=multiprocessing.cpu_count(),help='Number of parallel gcov to spawn (default: %d).'%multiprocessing.cpu_count())
parser.add_argument('-o','--output',dest='output',default="coverage.json",help='Name of output file (default: coverage.json)')
parser.add_argument('-i','--lcov',dest='lcov',action="store_true",help='Output in lcov info format instead of gcov json')
