Skip to content
/ kcov Public
forked from SimonKagstrom/kcov

Code coverage tool for compiled programs, Python and Bash which uses debugging information to collect and report data without special compilation options

License

Notifications You must be signed in to change notification settings

luehmann/kcov

Repository files navigation

Build Status Coverage Status

kcov

What is it?

Kcov is a code coverage tester for compiled languages, Python and Bash. Kcov was originally a fork of Bcov, but has since evolved to support a large feature set in addition to that of Bcov.

Kcov, like Bcov, uses DWARF debugging information for compiled programs to make it possible to collect coverage information without special compiler switches.

How to use it

The usage is simple:

kcov /path/to/outdir executable [args for the executable]

/path/to/outdir will contain lcov-style HTML output generated continuously while the application runs. Kcov will also write cobertura- compatible XML output and can upload coverage data directly to http://coveralls.io for easy integration with travis-ci.

Filtering output

It's often useful to filter output, since e.g., /usr/include is seldomly of interest. This can be done in two ways:

kcov --exclude-pattern=/usr/include --include-pattern=part/of/path,other/path \
      /path/to/outdir executable

which will do a string-comparison and include everything which contains part/of/path or other/path but exclude everything that has the /usr/include string in it.

kcov --include-path=/my/src/path /path/to/outdir executable
kcov --exclude-path=/usr/include /path/to/outdir executable

Does the same thing, but with proper path lookups.

Travis-ci / coveralls integration

kcov coverage collection is easy to integrate with travis-ci and coveralls.io. To upload data from the travis build to coveralls, run kcov with

kcov --coveralls-id=$TRAVIS_JOB_ID /path/to/outdir executable

which in addition to regular coverage collection uploads to coveralls.

More information

kcov is written by Simon Kagstrom [email protected] and more information can be found at the web page

About

Code coverage tool for compiled programs, Python and Bash which uses debugging information to collect and report data without special compilation options

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 56.4%
  • JavaScript 13.9%
  • Python 9.8%
  • C 9.6%
  • CMake 6.1%
  • CSS 1.3%
  • Other 2.9%