Skip to content

ryanluker/vscode-coverage-gutters

Repository files navigation

coverage-gutters

Display test coverage generated by lcov or xml in your editor.

Call for Maintainers

Looking for helpful people to assist with bugs, new features or performance improvements.
The project has a full suite of tests and code linting, making it very new contributor friendly.
Take a look at some of the open github issues and see if any catch your eye!
https://github.com/ryanluker/vscode-coverage-gutters/issues

Features

Coverage Gutters features watch

  • Supports any language as long as you can generate a lcov style coverage file
  • Extensive logging and insight into operations via the output logs
  • Multi coverage file support for both xml and lcov
  • Coverage caching layer makes for speedy rendering even in large files
  • Relative coverage file resolution for those with complex file paths
  • Preview coverage reports inside the editor
  • Huge amount of workspace settings to customize the features to your liking
  • Colour compatibility with light and dark themes
  • Custom coverage paths with a hot swapping feature for remote builds

Common Commands

Watch (activated via command palette or shortcut icon on the status bar): Activating watch allows the extension to keep track of coverage changes and update its cache. It also will automatically apply coverage to a file if some exists.

Display (activated via command palette or shortcut key): Displays coverage for the current activated file only, does not update if the coverage files change.

Preview Report (activated via command palette): Shows you a html preview of your coverage reports in your editor.

Officially Supported Languages (Backed by tests ran nightly)

See examples directory on how to setup a project.

Tips and Tricks

Using Breakpoints: Currently to both use the extension and code debugging breakpoints, you need to disable the gutter coverage and enable the line coverage via the settings ( coverage-gutters.showGutterCoverage and coverage-gutters.showLineCoverage respectively).

Requirements

  • vscode 1.27.0 and up
  • macos, linux or windows
  • Requires Live Preview extension
    • vscode extension id: ms-vscode.live-server
    • v0.2.12 or higher

Extension Settings

See extension setting options in IDE.

Known Issues

Release Notes

Contribution Guidelines

About the Maintainers

If you are interested in what else we work on, checkout the maintainers below!
https://luker.dev
https://github.com/mattseddon
https://github.com/timagixe
https://www.spodymek.com/
https://www.kayode.tech/
https://huddleco.com.au/


Icon made by Dave Gandy from www.flaticon.com is licensed by CC 3.0 BY