altcover 8.9.3
dotnet add package altcover --version 8.9.3
NuGet\Install-Package altcover -Version 8.9.3
<PackageReference Include="altcover" Version="8.9.3" />
paket add altcover --version 8.9.3
#r "nuget: altcover, 8.9.3"
// Install altcover as a Cake Addin #addin nuget:?package=altcover&version=8.9.3 // Install altcover as a Cake Tool #tool nuget:?package=altcover&version=8.9.3
altcover
Instrumenting coverage tool for .net (framework 2.0+ and core) and Mono assemblies, reimplemented and extended almost beyond recognition from dot-net-coverage, plus a set of related utilities for processing the results from this and from other programs producing similar output formats.
Usage
See the Wiki page for full details
I really want coverage for my .net core unit test project right now
Install into your test project
dotnet add package AltCover
and run
dotnet test /p:AltCover=true
The OpenCover format output will be in file coverage.xml
in the project directory
What's in the box?
For Mono, .net framework and .net core, except as noted
AltCover
, a command-line tool for recording code coverage (net472 and .netcoreapp2.0)- MSBuild tasks to drive the tool, including
dotnet test
integration - A PowerShell module for Windows PowerShell 5.1 and PowerShell Core 6+ containing a cmdlet that drives the tool, and other cmdlets for manipulating coverage reports
- A coverage visualizer tool (net472) -- for .net framework, needs GTK# v2.12.xx installed separately
Why altcover?
As the name suggests, it's an alternative coverage approach. Rather than working by hooking the .net profiling API at run-time, it works by weaving the same sort of extra IL into the assemblies of interest ahead of execution. This means that it should work pretty much everywhere, whatever your platform, so long as the executing process has write access to the results file. You can even mix-and-match between platforms used to instrument and those under test.
In particular, while instrumenting .net core assemblies "just works" with this approach, it also supports Mono, as long as suitable .mdb
(or .pdb
, in recent versions) symbols are available. One major limitation here is that the .mdb
format only stores the start location in the source of any code sequence point, and not the end; consequently any nicely coloured reports that take that information into account may show a bit strangely.
Why altcover? -- the back-story of why it was ever a thing
Back in 2010, the new .net version finally removed the deprecated profiling APIs that the free NCover 1.5.x series relied upon. The first version of AltCover was written to both fill a gap in functionality, and to give me an excuse for a ground-up F# project to work on. As such, it saw real production use for about a year and a half, until OpenCover reached a point where it could be used for .net4/x64 work (and I could find time to adapt everything downstream that consumed NCover format input).
Fast forwards to autumn 2017, and I get the chance to dust the project off, with the intention of saying that it worked on Mono, too -- and realise that it's déja vu all over again, because .net core didn't yet have profiler based coverage tools either, and the same approach would work there as well.
Continuous Integration
Build | GitHub |
Test coverage | Coveralls |
Possible retirement/obsolescence of support
tl;dr -- legacy framework/Mono support is not going away any time soon.
As net472
can consume netstandard2.0
libraries (everything but the recorder), and .net core 2+ can consume net20
libraries (the recorder), legacy framework/Mono support continues until such a time as it is no longer possible to retain those API levels.
Other NuGet Packages in this suite
- API install -- excludes the visualizer in all forms
- dotnet global tool install -- excludes the visualizer in all forms
- Visualizer dotnet global tool -- just the .net core/Avalonia Visualizer as a global tool
- FAKE build task utilities -- just AltCover related helper types for FAKE scripts (v5.23.0 or later), only in this package
- Cake build task utilities -- just AltCover related helper types for Cake scripts (v2.0.0 or later), only in this package
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net20 is compatible. net35 was computed. net40 was computed. net403 was computed. net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
This package has no dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (21)
Showing the top 5 popular GitHub repositories that depend on altcover:
Repository | Stars |
---|---|
jstedfast/MailKit
A cross-platform .NET library for IMAP, POP3, and SMTP.
|
|
praeclarum/sqlite-net
Simple, powerful, cross-platform SQLite client and ORM for .NET
|
|
ardalis/GuardClauses
A simple package with guard clause extensions.
|
|
danielpalme/ReportGenerator
ReportGenerator converts coverage reports generated by coverlet, OpenCover, dotCover, Visual Studio, NCover, Cobertura, JaCoCo, Clover, gcov or lcov into human readable reports in various formats.
|
|
jstedfast/MimeKit
A .NET MIME creation and parser library with support for S/MIME, PGP, DKIM, TNEF and Unix mbox spools.
|
Version | Downloads | Last updated |
---|---|---|
8.9.3 | 27,449 | 8/17/2024 |
8.8.173 | 16,378 | 7/27/2024 |
8.8.165 | 4,834 | 7/23/2024 |
8.8.74 | 45,212 | 5/31/2024 |
8.8.53 | 13,459 | 5/16/2024 |
8.8.21 | 40,202 | 4/15/2024 |
8.8.10 | 10,511 | 4/6/2024 |
8.7.3 | 28,566 | 3/14/2024 |
8.6.125 | 76,743 | 1/4/2024 |
8.6.95 | 25,568 | 11/14/2023 |
8.6.68 | 133,583 | 7/10/2023 |
8.6.61 | 26,028 | 6/6/2023 |
8.6.45 | 82,523 | 3/21/2023 |
8.6.40 | 14,146 | 3/16/2023 |
8.6.14 | 117,770 | 1/1/2023 |
8.5.842 | 12,085 | 12/25/2022 |
8.5.841 | 32,038 | 11/19/2022 |
8.4.840 | 51,771 | 10/17/2022 |
8.3.839 | 25,100 | 9/13/2022 |
This build from https://github.com/SteveGilham/altcover/tree/af20985812b322ad5cd49969c25bcef63d7ca840
Q. Never mind the fluff -- how do I get started?
A. Start with the Quick Start guide : https://github.com/SteveGilham/altcover/wiki/QuickStart-Guide and
read the FAQ : https://github.com/SteveGilham/altcover/wiki/FAQ
8.9.3 (Habu series release 33)
• Add -p/--package and equivalents to specify package roots for Cobertura output for all coverage collection methods, plus the PowerShell ConvertTo-Cobertura cmdlet
• [ADVISORY] The Fake.build related assemblies (in the altcover.api and altcover.fake packages) support Fake 6.1.0
• [PERFORMANCE] revise the OpenCover to LCov conversion to speed the mapping of methods from source files.
8.8.173 (Habu series release 32)
• [PERFORMANCE] Issue #227 - removing the slow-down observed the new (at 8.8.165) file name processing for Cobertura
• [PERFORMANCE] removing a surprising hot-spot in branch coverage instrumentation that was taking 60% of the whole instrumentation time
8.8.165 (Habu series release 31)
• [ADVISORY] the Fake.build related assemblies (in the altcover.api and altcover.fake packages), and the Avalonia 0.10-based visualizer, rely on components with known vulnerabilities. The Fake.build project appears nigh-moribund so has not released an update, whereas Avalonia 11 completely rewrites all the earlier APIs and has not documented anything to assist in the rewrite of the application.
• [BUGFIX] Issue #197 - correctly split file paths in the Cobertura output
• [NET9 preparation] Recode the recorder into C# as compiler/build target changes in F#9 make maintaining net2.0 compatibility in F# too much bother.
8.8.74 (Habu series release 30)
• [BUGFIX] Issue #222 - distinguish methods differing only in number of generic parameters (JSON and cobertura in particular, but with small changes for all all output formats)
• [BUGFIX] Issue #223 - handle degenerate source paths for Cobertura output
8.8.53 (Habu series release 29)
• [BUGFIX] Fix summary data for --outputFile option
• [BUGFIX] Fix interaction of --zipFile prepare option and --outputFile collect option
• [BUGFIX] Issue #220 - improve dependency resolution to the GAC
8.8.21 (Habu series release 28)
• [BREAKING; BUGFIX] Issue #206 : Update to net6+ for dotnet test integration and respect the $(IsTestProject) setting from the Microsoft.NET.Test.Sdk package.
• Simplify the use of the AltCover MSBuild tasks via the associated package-level .targets file by not even including the VSTest integration unless both '$(AltCover)' == 'true' AND '$(IsTestProject)' == 'true'.
• Mitigate instances of System.IO.IOException: The process cannot access the file '[coverage report]' because it is being used by another process.
• Explicitly add GAC locations to the paths inspected for dependency resolution
8.8.10 (Habu series release 27)
• [BUGFIX] Add Json member to the report format enumerations for the typesafe API and for the InvokeAltCover cmdlet.
• [BUGFIX] Issue #214 : patch Mono.Cecil to use FIPS compliant algorithm
• [Enhancement] Discussion #206, maybe also Issue #203 : Option --portable and equivalent APIs to place the coverage report file and related coverage data in the same folder as the recorder assembly, wherever that might be, allowing the whole instrumented folder structure to be moved into another file structure (e.g. different machine, different OS).
8.7.3 (Habu series release 26)
• [Enhancement] Discussion 202 : More careful tidying of temporary .runsettings files, fixing long-standing errors of both commission and omission.
• [Enhancement] Discussion 199 : Add /p:AltCoverOutputRoot=[path] and associated APIs for dotnet test command line creation. The [path] is a directory to be used instead of $(TargetDir) for the relative placing of the instrumented or saved files. The use-case here is when $(TargetDir) is close to MAX_PATH and the generated sub-folders would overflow that limit.
For previous releases (8.6.125 and earlier) go here -- https://github.com/SteveGilham/altcover/blob/master/ReleaseNotes%20-%20Previously.md