xaizek / uncov (License: AGPLv3+) (since 2018-12-07)
Uncov(er) is a tool that collects and processes code coverage reports.
File Mode Size
data/ 040000
docs/ 040000
doxygen/ 040000
scripts/ 040000
src/ 040000
tests/ 040000
web/ 040000
.gitignore 100644 250B
COPYING 100644 34KiB
INSTALL.md 100644 1,977B
Makefile 100644 8,035B
README.md 100644 5,741B
TODO.md 100644 9,224B
config.h.in 100644 87B
uncov-gcov 100755 21KiB

/README.md

uncov, v0.3, 2016 – 2020

This file last updated on 23 February, 2020

  1. Description
  2. Supported Environment
  3. Usage/example/screenshots
  4. Credits
  5. License

Description

uncov is a tool that collects and processes coverage reports.

By storing history of coverage reports it allows one to view how code coverage changes over time, compare changes that happened and view current state of the coverage.

The tool is deeply integrated with git repository of processed projects and thus avoids generation of static reports. Data is bound to repository information, but can be freely shared by several copies of the same repository (builds referring to unavailable git objects just won't be accessible).

Provided command-line interface should be familiar to most of git users and helps to avoid switching to a browser to verify code coverage.

It's also possible to display coverage information in a browser, say, on a CI server. This makes uncov something like self-hosted coveralls.io analogue (but note that Web-interface is secondary in this case and isn't feature complete).

Features

  • Code highlighting.
  • Comparison of coverage.
  • Displaying parts of files that need attention with regard to coverage.
  • Can be used from Vim via the plugin provided.
  • Can be used on CI to display coverage in a browser (via Web-UI).

Structure

Storage management tool itself is language independent and is relying on complementary tools to fetch and transform coverage data from language specific coverage harness.

Importer of coverage for C and C++ languages that collects data from gcov is provided.

Adding support for a language

Support for other languages can be added by converting existing coverage tools or even using them as is. The new-json subcommand accepts JSON that's used by coveralls.io API, all what's needed is to extract this JSON and pipe it to uncov new-json (some tools might already have a command-line option like --dump, others could be extended by adding it).

Status

Overall structure and basic elements are expected to remain in place, however they aren't finalized and changes for the sake of improvement are possible. Databases will be migrated if schema changes, so previously collected data won't be lost.

Main things missing

  • Configuration. Currently values that could be configurable are hard-coded.
  • Tuning behaviour with command-line parameters.

Supported Environment

Expected to work in Unix-like environments.

Prerequisites

Usage

# drop coverage counters from previous run
find . -name '*.gcda' -delete
# < run tests at this point >
uncov new-gcovi --exclude tests/ --exclude web/ --capture-worktree

Example

The easiest way of checking out uncov is by using it on itself (assuming that you have just built it or just happen to have all the necessary development dependencies).

In root of the project run make self-coverage and then do release/uncov build to see something similar to:

build

release/uncov dirs shows coverage per directory:

dirs

release/uncov changed shows files which have their coverage changed:

changed

release/uncov show src/SubCommand.cpp shows annotated src/SubCommand.cpp file:

show

When most of a file is covered, one probably wants to see just what's not yet covered, this can be done with release/uncov missed command:

missed

More Screenshots

Not everything can be demonstrated by self-coverage example above, so here are some other interesting things. List of latest builds (uncov builds):

builds

Results of comparison (uncov diff):

diff

Annotated source code in Web-UI:

Web-UI

Annotated diff in Web-UI:

Web-UI

Web-UI Demo

Deployed Web-interface can be seen here.

Credits

  • LCOV project is the source of useful ideas and primary source of inspiration.
  • coveralls.io service is second project which significantly shaped this tool.
  • Code of uncov-gcov is based on cpp-coveralls.
  • gcov-marker.vim was the source of idea of filling location list with not covered lines in the plugin.

License

AGPLv3

Version 3 of the GNU Affero General Public License.

Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/uncov

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/uncov

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master