xUnit VS NUnit

Attachments: At this time you still cannot attach files to test runs, although the functionality finally is coming in V3!

I was trying to think of an example of where C# attributes might be used in every day life and then it dawned on me: unit testing! If you have ever used a unit test framework such as MSTest, NUnit or xUnit, you will have used attributes in C# to define the classes and methods that you would like the test framework to execute. This is just one example of how you can use attributes to assign metadata to elements of your code.

Because I struggled with the initial tests written using MSTest, I converted all the tests to xUnit – some of this was out of sheer comfort with xUnit over MSTest, but also because its OSS product under the .NET Foundation – and I like supporting those.

I didn't want to create "yet another test runner," but I couldn't get any of the existing ones to do everything I needed. It's fairly well known that you can't run or debug xunit tests in a Godot game unless you're using Rider, and since I'm a die-hard VSCode user, I didn't want to make the switch. XUnit also runs tests in parallel by default, which isn't usually what I want in a game-like environment, so it just felt like a poor fit overall.

The setup here is really minimal, just create a new test project. I'll be using xUnit but NUnit should be fine too.

xUnit

If you're using xUnit for your tests, you can implement the IAsyncLifetime interface it helpfully provides for you.

The projects are all .NET 6 applications with nullable references types and implicit usings enabled. The unit testing projects use Xunit out of the box. There are also support files such as .gitignore, .editorconfig, etc.

The testing framework that I chose is XUnit. The first reason is that it is trendy compared to another test framework such as NUnits. I created test methods stub from the existing code by Create Unit Tests command. To use it with Xunit, I have to implement the XUnit.net.TestGenerator extension to my project.

**NUnit**

This is a basic example of how to create an NUnit unit test for a simple API in a controller with C#. You can find more information and resources on the NUnit website and in the NUnit documentation.

I was trying to think of an example of where C# attributes might be used in every day life and then it dawned on me: unit testing! If you have ever used a unit test framework such as MSTest, NUnit or xUnit, you will have used attributes in C# to define the classes and methods that you would like the test framework to execute. This is just one example of how you can use attributes to assign metadata to elements of your code.

The setup here is really minimal, just create a new test project. I'll be using xUnit but NUnit should be fine too.

Meanwhile NUnit has had multiple releases since 2018: https://www.nuget.org/packages/NUnit/

There are unit testing frameworks for most popular programming languages. Some examples of popular unit test frameworks are Jest for Javascript, JUnit for Java, and NUnit for all .Net languages.

https://www.nuget.org/packages/Newtonsoft.Json/ https://www.nuget.org/packages/AutoMapper/ https://www.nuget.org/packages/Dapper/ https://www.nuget.org/packages/FluentValidation/ https://www.nuget.org/packages/FluentAssertions/ https://www.nuget.org/packages/NUnit/ https://www.nuget.org/packages/xunit/ https://www.nuget.org/packages/YamlDotNet/ https://www.nuget.org/packages/Moq/ That is simply not true. Mature c# projects purposely maintain no downstream dependencies and is they do, it's to a major reputable lib. See for yourself - these are staple third party packages commonly used. Anything dependency starting with System or NETStandard is Microsoft maintained.

NUnit, FluentAssertions, Moq & Respawn