codecoverage

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 124)

Microsoft Code Coverage tools documentation and samples

codecoverage Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Microsoft code coverage tools

Microsoft code coverage functionality is closed source. This repository contains documentation and samples. You can also use it to report any issues related to `Microsoft.CodeCoverage` NuGet package, `dotnet-coverage` NuGet package or Visual Studio code coverage functionality.

## Contents

- [Get started](#get-started)
- [Documentation](#documentation)
- [Samples](#samples)
- [Contributing](#contributing)
- [Trademarks](#trademarks)

## Get started

To collect code coverage for .NET test project you can simply execute:

```shell
dotnet new mstest -o mstests
cd mstests
dotnet test --collect "Code Coverage;Format=cobertura"
```

You should see output:

<details>
<summary>Show expected output</summary>

```shell
Determining projects to restore...
  All projects are up-to-date for restore.
  mstests -> D:\mstests\bin\Debug\net8.0\mstests.dll
Test run for D:\mstests\bin\Debug\net8.0\mstests.dll (.NETCoreApp,Version=v8.0)
Microsoft (R) Test Execution Command Line Tool Version 17.8.0 (x64)
Copyright (c) Microsoft Corporation.  All rights reserved.

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     1, Skipped:     0, Total:     1, Duration: 16 ms - mstests.dll (net8.0)

Attachments:
  D:\mstests\TestResults\caf685fa-04ce-4858-9feb-ae472f1a71e1\dd166e58-6e19-4741-931a-816d025fcb32.cobertura.xml
```

</details>

For any .NET application you can collect code coverage in this way:

```shell
dotnet new console -o sample1
cd sample1
dotnet tool install -g dotnet-coverage
dotnet-coverage collect "dotnet run"
```

You should see output:

<details>
<summary>Show expected output</summary>

```shell
dotnet-coverage v18.8.0 [win-x64 - .NET 8.0.23]

SessionId: f2255bb7-259f-4c01-8360-bf7be4f8c5f8
Hello, World!
Code coverage results: output.coverage.
```

</details>

For existing projects to get latest features and best performance please keep up to date below references:

```xml
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.7.0" />
<PackageReference Include="Microsoft.CodeCoverage" Version="18.7.0" />
```

If your solution doesn't contain any C++ code it is recommended to disable native code coverage by adding into configuration below flags:

```xml
<EnableStaticNativeInstrumentation>False</EnableStaticNativeInstrumentation>
<EnableDynamicNativeInstrumentation>False</EnableDynamicNativeInstrumentation>
```

Check other configuration options [here](docs/configuration.md).

## Documentation

* Documentation for `dotnet-coverage` tool is available [here](https://aka.ms/dotnet-coverage).
* Documentation for `Microsoft.CodeCoverage` is available [here](https://learn.microsoft.com/visualstudio/test/customizing-code-coverage-analysis)
* [Static and dynamic instrumentation](docs/instrumentation.md)
* [Supported OS versions](docs/supported-os.md)
* [Configuration](docs/configuration.md)
* [Performance data](docs/performance/README.md)

## Samples

* [Unit tests, E2E, console applications, merging, exclusions, static instrumentation](samples/Calculator/README.md)
* [MSTest Runner, Native AOT](samples/Algorithms/README.md)
* [Visual Studio](samples/VisualStudio/README.md)

## Contributing

This project welcomes contributions and suggestions.  Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit [Contributor License Agreements](https://opensource.microsoft.com/cla/).

When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

## Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.

codecoverage

codecoverage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

codecoverage

codecoverage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README