Project

gcovinator

0.0
No commit activity in last 3 years
No release in over 3 years
gcovinator generates HTML reports for gcov coverage data. It provides a command-line executable that can be run after the .gcda and .gcno files are present. It executes gcov, reads the .gcov output files, and combines the original source files with the coverage data into HTML reports.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 1.13
~> 10.0
~> 3.0
 Project Readme

Gcovinator

gcovinator is a command-line tool that can generate HTML reports showing the line and branch coverage information for a source file. It is implemented as a Ruby gem and requires Ruby to be installed to execute.

Installation

With root access or something like rvm:

$ gem install gcovinator

Or as an unprivileged user without something like rvm:

$ gem install --user gcovinator

(in this case make sure the path to /bin under your ~/.gem directory is in your $PATH)

Usage

Usage: gcovinator [options] [FILES]

Pass paths to .gcda files as FILES.
If no FILES are specified, gcovinator looks for all .gcda files recursively under the build directory.

Options:
    -b, --build-dir BUILDDIR         Specify the build directory. Source file paths in object/gcov files will be relative to this directory. Defaults to '.' if not specified.
    -o, --output-dir OUTPUTDIR       Specify output directory. HTML reports will be written to this directory. Defaults to 'coverage' if not specified.
    -p, --prefix PREFIX              Prefix path to strip from source file paths. Defaults to '.' if not specified.
    -s, --source-dir SRCDIR          Specify a source directory. Reports will only be generated for sources under a specified source directory. Multiple source directories may be specified. Defaults to '.' if not specified.
    -h, --help                       Show this help.
        --version                    Show version

Example

If you store your source code under src and build from the build directory, then execute:

$ gcovinator -b build -s src

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/holtrop/gcovinator.

License

The gem is available as open source under the terms of the MIT License.