Release Notes: May 28, 2018

xUnit.net v2 2.4 Beta 2

We have made the difficult decision to stop shipping the dotnet xunit runner. Though we have invested significant effort into the runner, it remains a source of bugs that stem fundamentally from the fact that it's trying to do things which are outside the bounds of the normal execution rules for .NET Core.

Users should revert back to using dotnet test for the time being. For more information, see Getting started with xUnit.net (.NET Core / ASP.NET Core).

Core framework

• Fixture objects (class & collection fixtures) can now accept IMessageSink as a constructor argument. This message sink only accepts diagnostic messages (that is, IDiagnosticMessage).

Assertion library

• Added overloads to Assert.Contains and Assert.DoesNotContain for dictionaries. The expected value for these assertions is the dictionary key. Assert.Contains returns the value for the given key, when the key is present.
• Added overload to Assert.Equal for DateTime comparison, which accepts a TimeSpan precision argument.
• Performance improvement for Assert.Single to prevent enumerating the whole container.

Console runner

• The console runner is now compiled for all Desktop CLR versions, from 4.5.2 through 4.7.2. The xunit.runner.console NuGet package includes binaries inside the tools folder. In addition there are new MSBuild properties that are available for projects which reference this package, which point to the new executables:
  • XunitConsole452Path (.NET 4.5.2 AnyCpu)
  • XunitConsole452PathX86 (.NET 4.5.2 32-bit)
  • XunitConsole46Path (.NET 4.6 AnyCpu)
  • XunitConsole46PathX86 (.NET 4.6 32-bit)
  • XunitConsole461Path (.NET 4.6.1 AnyCpu)
  • XunitConsole461PathX86 (.NET 4.6.1 32-bit)
  • XunitConsole462Path (.NET 4.6.2 AnyCpu)
  • XunitConsole462PathX86 (.NET 4.6.2 32-bit)
  • XunitConsole47Path (.NET 4.7 AnyCpu)
  • XunitConsole47PathX86 (.NET 4.7 32-bit)
  • XunitConsole471Path (.NET 4.7.1 AnyCpu)
  • XunitConsole471PathX86 (.NET 4.7.1 32-bit)
  • XunitConsole472Path (.NET 4.7.2 AnyCpu)
  • XunitConsole472PathX86 (.NET 4.7.2 32-bit)
• A new reporter (-junit) was added to emit results in the JUnit XML format.
• Fixed a compatibility issue with .NET 4.7.2 to allow portable PDBs.

MSBuild runner

• A new reporter (JUnit) was added to emit results in the JUnit XML format.

Copyright © .NET Foundation. Contributions welcomed at https://github.com/xunit/xunit/tree/gh-pages.