#cargo #subcommand #coverage #gcov #lcov

app cargo-cov

Collect source coverage via LLVM-GCOV (⚠ not fully tested, may eat your laundry)

4 releases

Uses old Rust 2015

0.0.5 Aug 29, 2018
0.0.4 Jun 18, 2018
0.0.3 Nov 18, 2017
0.0.1 Jun 13, 2017

#6 in #lcov

49 downloads per month

MIT license

4.5K SLoC

Rust 4K SLoC // 0.0% comments JavaScript 433 SLoC // 0.2% comments Python 111 SLoC C++ 18 SLoC

cargo-cov: Source coverage for Rust

cargo-cov is a cargo subcommand which performs source coverage collection and reporting for Rust crates. cargo-cov utilizes LLVM's gcov-compatible profile generation pass, and supports a lot of platforms.

  • ✓ FreeBSD, Linux, macOS, Windows (MSVC only)
  • ✓ x86_64, x86

Usage: for Local Testing on nightly Rust

You may install cargo-cov via cargo.

cargo install cargo-cov

The typical workflow is like this:

# clean up previous coverage result
cargo cov clean

# test the code
cargo cov test

# open the coverage report
cargo cov report --open

Usage: for Testing on stable Rust (1.19+)

We strongly recommend you use nightly Rust since only the nightly toolchain has built-in instrumented profiling support via -Zprofile.

If you must use a stable toolchain, you may try the following:

  1. Install the compiler-rt profile library.

    Target Instruction
    Ubuntu, Debian Install libclang-common-7-dev, or simply install clang
    Fedora Install compiler-rt
    OpenSUSE Install llvm-clang
    Windows (MSVC) Install Clang for Windows Pre-Built Binary from LLVM
    macOS, iOS Provided by the Xcode command line tools
    Android Provided by Android NDK
  2. Execute the doc-test separately from the normal tests. Run the doc-test before the normal tests.

    # Run --doc tests before other things before 1.19
    cargo cov test --doc
    cargo cov test --lib

We do not guarantee that a correct coverage profile will be generated using this method.


~319K SLoC