Running .NET Core 3 XUnit Code Coverage in AppVeyor Using OpenCover and Codecov

petrsvihlik

Petr Švihlík

Posted on December 1, 2019

Running .NET Core 3 XUnit Code Coverage in AppVeyor Using OpenCover and Codecov

I love AppVeyor. It's my go-to CI/CD service for .NET projects. I use it for both personal and work open-source projects. I also love automation of all kinds so, among other things, I want my test coverage reports to be automatically generated with every build.

Recently, I started upgrading my project portfolio to .NET Core 3.0. With that, I also wanted to level-up my unit tests which are typically XUnit. I didn't want to introduce too much change to my code so, after some research, I decided to stick with the following setup: AppVeyor (which I've already been using) + Codecov (which we use for another project at work) + OpenCover.

Custom PowerShell coverage script 📜

The goal was to create a minimalistic, reusable piece of code (independent of environment settings, tool versions, etc.) that I could use across multiple projects. Here it goes:

coverage.ps1

The script can run locally and in AppVeyor with slightly different configurations. The most tricky part is:

$register = if ($ENV:APPVEYOR -eq $true ) { '-register' } else { '-register:user' }
Enter fullscreen mode Exit fullscreen mode

When I finally made the script run on my local machine, it started failing in AppVeyor. It took me a few hours of digging and debugging to figure out that I can't use -register:user in AppVeyor. Fortunately, debugging is quite easy in AppVeyor as you can RDP to the build worker.

I highly recommend reading OpenCover's documentation. It'll help you understand the syntax of targetArgs, filter and register parameters.

Hooking the script into the CI pipeline 🔗

AppVeyor supports Chocolatey so I'm using cinst to install OpenCover and Codecov CLIs. Then I'm turning off the default test script and replacing it with my own which runs OpenCover to generate the coverage files, and finally, I'm calling Codecov CLI to upload the results.

Cool thing is that if you run codecov -f coverage.xml from AppVeyor you don't need an API key. It just works automagically ✨.

appveyor.yml

The result

I've got this nice sunburst chart indicating which files need attention:

Codecov sunburst

I've also got the Codecov badge with % coverage:

GitHub logo Kentico / kontent-delivery-sdk-net

Kentico Kontent Delivery .NET SDK

Kentico Kontent Delivery .NET SDK

Build & Test codecov Stack Overflow Discord

Paradigm Package Downloads Compatibility Documentation
Async NuGet NuGet netstandard2.0 📖
Reactive NuGet NuGet netstandard2.0 📖

Summary

The Kentico Kontent Delivery .NET SDK is a client library that lets you easily retrieve content from Kentico Kontent.

Getting started

Installation via Package Manager Console in Visual Studio:

PM> Install-Package Kentico.Kontent.Delivery 
Enter fullscreen mode Exit fullscreen mode

Installation via .NET CLI:

> dotnet add package Kentico.Kontent.Delivery 
Enter fullscreen mode Exit fullscreen mode

Usage

To retrieve content from your Kentico Kontent projects, you'll be using an implementation of the IDeliveryClient interface. This is the main interface of the SDK. Here's how you can instantiate and use the Delivery client either with DI/IoC or without DI/IoC.

Use dependency injection (ideal for ASP.NET Core web apps)

Startup.cs

public void ConfigureServices(IServiceCollection services)
{
    services.AddDeliveryClient(Configuration);
}
Enter fullscreen mode Exit fullscreen mode

HomeController.cs

public class HomeController
{
    private IDeliveryClient _client;

    public HomeController(IDeliveryClient deliveryClient)
    {
        _client = deliveryClient;
    }
}
Enter fullscreen mode Exit fullscreen mode

In…

And last but not least, a nice ASCII art in the AppVeyor log here:
Alt Text

So far, I have successfully tested this approach in two repos so I hope it'll work for you too. Any improvements are welcome!

💖 💪 🙅 🚩
petrsvihlik
Petr Švihlík

Posted on December 1, 2019

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related