Quick Start Guide
New to covdbg? We have you covered! This guide will help you get started with installing and using covdbg for code coverage analysis on Windows. We have prepared a Quick Start Guide that walks you through building a sample application, and collecting coverage data step-by-step.
About the Quick Start Guide
The quick-start repository contains everything you need to learn covdbg hands-on:
| File/Folder | Description |
|---|---|
README.md | Step-by-step instructions for building and running the sample |
CMakeLists.txt | CMake build configuration for the sample project |
.covdbg.yaml | Example covdbg configuration file with recommended settings |
src/ | Sample C++ source files to demonstrate coverage collection |
Clone the repository and follow the README to build the sample application, run tests under covdbg, and generate your first coverage report.
What’s Next?
- Refine filters: See Configuration Reference for advanced patterns
- Automate in CI: Set up GitHub Actions for automated coverage
- Merge runs: Use
covdbg mergeto combine coverage from multiple test runs - Analyze uncovered code: Use
covdbg analyzeto include unexecuted code in reports
Quick Reference
| Task | Command |
|---|---|
| Run coverage | covdbg --config .covdbg.yaml --output out.covdb tests.exe |
| Export LCOV | covdbg convert -i out.covdb -f LCOV -o coverage.lcov |
| Export GCOV | covdbg convert -i out.covdb -f GCOV -o ./gcov/ |
| Merge databases | covdbg merge -i a.covdb -i b.covdb -o merged.covdb |
| Analyze binary | covdbg analyze -i app.exe -o symbols.covdb |
See the CLI Reference for complete command documentation.