Awesome Open Source
Awesome Open Source


Code Coverage Tool for .NET Core

Build Status Nuget Coverage Status

Supported .NET Core SDKs

  • 2.1 (Global tool)
  • 2.2 (Global tool)
  • 3.0 (Global tool or local tool)
  • 3.1 (Global tool or local tool)
  • 5.0 (Global tool or local tool)


MiniCover can be installed as a global tool:

dotnet tool install --global minicover

Or local tool:

dotnet tool install minicover


This is a simplified documentation of MiniCover commands and options.

Use --help for more information:

minicover --help

When installed as local tool, MiniCover commands must be prefixed with dotnet. Example:

dotnet minicover --help


minicover instrument

Use this command to instrument assemblies to record code coverage.

It is based on the following main options:

option description type default
sources source files to track coverage glob src/**/*.cs
exclude-sources exceptions to source option glob **/bin/**/*.cs and **/obj/**/*.cs
tests test files used to recognize test methods glob tests/**/*.cs and test/**/*.cs
exclude-tests exceptions to tests option glob **/bin/**/*.cs and **/obj/**/*.cs
assemblies assemblies considered for instrumentation glob **/*.dll
exclude-assemblies Exceptions to assemblies option glob **/obj/**/*.dll

Note 1: Assemblies not related to sources or tests are automatically ignored.

Note 2: Supported syntax for glob values.

Note 3: You can repeat glob options to represent multiple values. Example: --sources "a/**/*.cs" --sources "b/**/*.cs"

This command also generates a coverage.json file with information about the instrumented code.


minicover uninstrument

Use this command to revert the instrumentation based on coverage.json file.

Make sure you call uninstrument before publishing or packing your application.


minicover reset

Use this command to reset the recorded coverage so far.


minicover report

Use this command to print a coverage report in the console.

The command exits with failure if the coverage doesn't meet a specific threshold (90% by default).

More commands

  • cloverreport: Write an Clover-formatted XML report to file
  • coberturareport: Write a cobertura XML report to file
  • coverallsreport: Prepare and/or submit coveralls reports
  • htmlreport: Write html report to folder
  • opencoverreport: Write an OpenCover-formatted XML report to file
  • xmlreport: Write an NCover-formatted XML report to file

Use --help for more information.

Build script example

dotnet restore
dotnet build

# Instrument
minicover instrument

# Reset hits
minicover reset

dotnet test --no-build

# Uninstrument
minicover uninstrument

# Create html reports inside folder coverage-html
minicover htmlreport --threshold 90

# Console report
minicover report --threshold 90

Ignore coverage files

Add the following to your .gitignore file to ignore code coverage results:



When using MiniCover libraries:

  • use dependency injection to create instances
  • use only the main interfaces listed on each package below

By doing that, you reduce the risk of being impacted by future MiniCover changes.


Main MiniCover operations.

Dependency injection configuration:


Main interfaces:

  • IInstrumenter
  • IUninstrumenter
  • IHitsReader
  • IHitsResetter


MiniCover reports.

Dependency injection configuration:


Main interfaces:

  • ICloverReport
  • ICoberturaReport
  • IConsoleReport
  • ICoverallsReport
  • IHtmlReport
  • IHtmlSourceFileReport
  • INCoverReport
  • IOpenCoverReport

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Sharp (276,133
Dotnet (7,612
Dotnet Core (4,295
Netcore (1,539
Netcore (1,539
Coverage (648
Code Coverage (206
Related Projects