lcov-util

maintenance status: passively-maintained license crates.io rust 1.56.1+ badge Rust CI codecov

Utility commands to manipulate and analyze LCOV tracefiles blazingly fast.

[LCOV] is a graphical front-end for coverage testing tool [gcov]. It collects gcov data for multiple source files and stores them into the file called as "tracefile".

The purpose of this crate is to operate the LCOV tracefile faster than the original LCOV Perl implementation.

Install

console cargo install lcov-util

Performance

Merge LCOV tracefiles

Comparing the execution of merging LCOV tracefiles, between 3 programs:

with 3 datasets (generated by mkinfo tool from LCOV repository):

| | small | medium | large | | ---------------- | ----- | ------ | ------- | | lcov 1.16 | 0.22s | 2.41s | 21.69s | | lcov master | 0.23s | 2.30s | 21.34s | | lcov-merge | 0.01s | 0.21s | 2.73s |

In this benchmark, lcov-merge is 10-20x faster than lcov 1.16 / lcov-master.

See benchsuite directory for details.

Minimum supported Rust version (MSRV)

The minimum supported Rust version is Rust 1.56.1. At least the last 3 versions of stable Rust are supported at any given time.

While a crate is pre-release status (0.x.x) it may have its MSRV bumped in a patch release. Once a crate has reached 1.x, any MSRV bump will be accompanied with a new minor version.

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in lcov by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.