We’ve started writing application code for Request Metrics. That code needs to be tested. Before we start testing, we need a unit test framework for our .NET Core solution. We’ve used various frameworks on our .NET projects over the years, but enough has changed in .NET Core to require a small investigation into unit testing options.
Our ideal unit test framework is simple and doesn’t bog us down in boiler-plate or strict naming conventions. At the same time, it should be powerful enough to do the testing we need.
We decided to use NUnit for our tests. It has worked so far and has not yet gotten in our way. We chose it for a number of reasons:
- Easy to Set Up Just start with the pre-built project template in Visual Studio!
- Simple Interface The NUnit API makes good compromises between simplicity and features.
- Cross Platform Works on most IDE’s in both Windows and Mac.
- Bad Memories of MSTests Past We’re too traumatized to consider trying it again.
Creating a New .NET Core NUnit Test Project
The easiest way to create a new NUnit project is to use the built in Visual Studio template. The hardest part is finding it:
- Select File -> New -> Project…
- Search for “nunit test” and select “NUnit Test Project (.NET Core)”
- Name the project and click “Create”:
What Did Visual Studio Do?
While the template didn’t do a whole lot for us, it did add one key piece of magic. Looking at package references for the test project reveals a dependency named
NUnit3TestAdapter. This test adapter is what allows .NET core to run our NUnit tests as natively as if they were MSTest:
NUnit Test Basics
We’re not going deep into testing yet. We just want to verify that NUnit works in the environments and IDE’s we use. A basic test skeleton is enough for now:
Sometimes we need to run setup code once before the test run. NUnit supports this through any class with the
Our testing framework is off to a good start. We’ll put have our test project to good use next time when we start designing our Redis data model.