Contributions are highly welcome, however, except for very small changes, kindly file an issue and let's have a discussion before you open a pull request.
Clone this repo:
git clone https://github.com/tonerdo/coverlet.git
cd coverlet
Building, testing, and packing use all the standard dotnet commands:
dotnet build
dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:Include="[coverlet.*]*"
dotnet pack
There is a simple performance test for the hit counting instrumentation in the test project coverlet.core.performancetest. Build the project with the msbuild step above and then run:
dotnet test /p:CollectCoverage=true test/coverlet.core.performancetest/
The duration of the test can be tweaked by changing the number of iterations in the [InlineData] in the PerformanceTest class.
For more realistic testing it is recommended to try out any changes to the hit counting code paths on large, realistic projects. If you don't have any handy https://github.com/dotnet/corefx is an excellent candidate. This page describes how to run code coverage tests for both the full solution and for individual projects with coverlet from nuget. Suitable projects (listed in order of escalating test durations):
- System.Collections.Concurrent.Tests
- System.Collections.Tests
- System.Reflection.Metadata.Tests
- System.Xml.Linq.Events.Tests
- System.Runtime.Serialization.Formatters.Tests
Change to the directory of the library and run the msbuild code coverage command:
dotnet test /p:Coverage=true
To run with a development version of coverlet call dotnet run instead of the installed coverlet version, e.g.:
dotnet test /p:Coverage=true /p:CoverageExecutablePath="dotnet run -p C:\...\coverlet\src\coverlet.console\coverlet.console.csproj"