coveralls.net
Coveralls uploader for .Net Code coverage of your C# source code. Should work with any code files that get reported with the supported coverage tools, but the primary focus is CSharp.
Install
The new way
The new way is using the dotnet SDK 2.1 tools. This can be installed from version 1.0.0. This requires dotnet sdk version 2.1 to be installed.
# install globally
dotnet tool install -g coveralls.net --version 1.0.0
# install into a local folder
dotnet tool install coveralls.net --version 1.0.0 --tool-path tools
To run the new version, simply use the command:
# if installed globally, this should just be available on your path
csmacnz.Coveralls <args>
# if installed into a tools path, you can run it from there.
.\tools\csmacnz.Coveralls <args>
Haven't got the latest tools? You can still use the new version thanks to the published zip stand-alone app versions. These can be found in GitHub Releases for each platform, window
, linux
and osx
.
For example on windows, you can download and unzip the windows stand-alone version:
# The TLS change was necessary on my development machine
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zipDownloadPath="https://github.com/csMACnz/coveralls.net/releases/download/1.0.0/coveralls.net.1.0.0-windows.zip"
Invoke-WebRequest -UseBasicParsing $zipDownloadPath -OutFile coveralls-windows.zip
mkdir coveralls-windows
Expand-Archive .\coveralls-windows.zip coveralls-windows
.\coveralls-windows\csmacnz.Coveralls.exe
The old way
Version 0.7.0 is still available on nuget at www.nuget.org/packages/coveralls.net. This is a full .Net Framework exe that even runs on mono.
To install coveralls.net you can find it by searching for coveralls.net
in the visual studio nuget extension, or install by running this command in the Package Manager Console.
PM> Install-Package coveralls.net -Version 0.7.0
You can get help for this older version using:
# on windows
csmacnz.Coveralls.exe --help
#on mono
mono csmacnz.Coveralls.exe --help
For more information, checkout the old version readme: https://github.com/csMACnz/coveralls.net/blob/release-0.7.0/README.md
How To Use
Head over to the wiki for user guidance on how it works.
Samples
Sample applications using Coveralls.net to publish their results can be found in the csmacnz/Coveralls.net-Samples Project.
Supported
- OpenCover
- Mono Code Coverage (monocov)
- Visual Studio's Dynamic Coverage (based on ReportGenerator's support, using vstest.console.exe and CodeCoverage.exe)
- Visual Studio Coverage Export xml format
- lcov
- NCover (classic 1.5.x format, at least)
- Chutzpah - A JavaScript Test Runner
- ReportGenerator
- Coverlet (via its opencover output format
/p:CoverletOutputFormat=opencover
)
Full Supported, In Progress, and Future Support information can be found Coverage Support wiki page
Issues
Follow development progress, report bugs and suggest features using github issues (also available at waffle.io)
Follow The App
You can ask questions and get updates using the twitter account coveralls.net (@coverallsdotnet).
Contributers
Mark Clearwater (Owner)
- @csMACnz on twitter
- csMACnz on github
- csmacnz@csmac.co.nz on email
Graphs
Throughput of this project (thanks to waffle.io)