SaturdayMP.NConstraints
1.1.1
dotnet add package SaturdayMP.NConstraints --version 1.1.1
NuGet\Install-Package SaturdayMP.NConstraints -Version 1.1.1
<PackageReference Include="SaturdayMP.NConstraints" Version="1.1.1" />
paket add SaturdayMP.NConstraints --version 1.1.1
#r "nuget: SaturdayMP.NConstraints, 1.1.1"
// Install SaturdayMP.NConstraints as a Cake Addin #addin nuget:?package=SaturdayMP.NConstraints&version=1.1.1 // Install SaturdayMP.NConstraints as a Cake Tool #tool nuget:?package=SaturdayMP.NConstraints&version=1.1.1
NConstraints
Adds additional constraints to NUnit such as comparing the properties of two objects.
Installing
Install by adding the SaturdayMP.NContraints NuGet package:
dotnet add package SaturdayMP.NConstraints
You can find alternative install methods on the NuGet page.
NConstraints is compatible with .NET Standard 2.0 and NUnit 3. If you would like to use NConstraints on a older project please try v1.0.0 which is compatiable with .NET Standard 1.6.
If you want the live on the wild side you can find the alpha/beta NuGet packages on MyGet.
Please report issues with the installation by opening an issue or pull request. Feel free to ping me if you want to use NConstraints with an older versions of NUnit and/or .NET and I'll see what I can do.
Quickstart
using NUnit.Framework; // Assume you already added this
using SaturdayMP.NConstraints; // Add this statement.
using Is = SaturdayMP.NConstraints.Is; // Add this statement.
Now you can write:
Assert.That(expected, Is.EquivalentPropertyWiseTo(actual);
Details
NConstratins extends the Is helper class which is used when writting Assert.That statements. For example:
Assert.That(expected, SaturdayMP.NConstraints.Is.EquivalentPropertyWiseTo(actual);
If you don't want to prifix the additional constratins with the SaturdayMP.NConstraints namespace then add the following to the top your test file:
using NUnit.Framework; // Assume you already added this
using SaturdayMP.NConstraints; // Add this statement.
using Is = SaturdayMP.NConstraints.Is; // Add this statement.
Now you can write:
Assert.That(expected, Is.EquivalentPropertyWiseTo(actual);
The complete file of this example looks like:
using NUnit.Framework;
using SaturdayMP.NConstraints;
using Is = SaturdayMP.NConstraints.Is;
namespace MyTestNamespace
{
[TestFixture]
public class MyTests
{
[Test]
public void PropertiesAreTheSame()
{
var expected = new TestClass() { IntegerProperty = 1 };
var actual = new TestClass() {IntegerProperty = expected.IntegerProperty};
Assert.That(expected, Is.EquivalentPropertyWiseTo(actual));
}
}
}
Notice that the using statement set the Is object. If you try:
using NUnit.Framework;
using SaturdayMP.NConstraints;
You will get compile errors because there are two Is classes, one in the NUnit.Framework namespace and one in SaturdayMP.NConstraints.
Finally some code analyizers, like ReSharper, will raise warnings like "Access to a static member or a type via a dirvied type". You can safely ignore these warnings, I don't know a good way to remove these warnings. If you do please open an issue or pull request.
Constraints
This project adds the following constraints to NUnit:
Constraint Name | Description |
---|---|
EquivalentPropertyWiseTo | Asserts that the property values of expected object are the same on the actual object. |
EquivalentPropertyWiseTo
Asserts that the property values of expected object are the same on the actual object. The objects don't have to be the same class but if a property exists on the expected object but not on the actual object then the assert fails.
/// <summary>
/// Objects are equivalent if they have the same properties and they are all the same.
/// </summary>
[Test]
public void PropertiesTheSame()
{
var expected = new TestClass() {IntegerPropery = 1, StringPropery = "Test"};
var actual = new TestClass() {IntegerPropery = expected.IntegerPropery, StringPropery = expected.StringPropery};
Assert.That(expected, Is.EquivalentPropertyWiseTo(actual));
}
/// <summary>
/// Objects are alos equivalent if all the property values match but actual has properties not on actual.
/// </summary>
[Test]
public void PropertiesTheSame()
{
var expected = new TestClass() {IntegerPropery = 1, StringPropery = "Test"};
var actual = new TestClass2() {IntegerPropery = expected.IntegerPropery, SecondIntegerProperty = 2, StringPropery = expected.StringPropery};
Assert.That(expected, Is.EquivalentPropertyWiseTo(actual));
}
/// <summary>
/// Objects are NOT equivalent if expected has a property not on actual.
/// </summary>
[Test]
public void PropertyDoesNotExistOnActual()
{
var expected = new TestClass2() { IntegerPropery = 1, SecondIntegerProperty = 2, StringPropery = "Test"};
var actual = new TestClass() { IntegerPropery = expected.IntegerPropery, StringPropery = expected.StringPropery};
Assert.That(expected, Is.Not.EquivalentPropertyWiseTo(actual))
}
Contributing
If you have any questions, notice a bug, or have a suggestion/enhancment please let me know by:
- opening a issue or pull request.
- asking a question on StackOverflow with the tag nconstraints.
- send an e-mail to support@saturdaymp.com.
Acknowledgements
Thanks to the NUnit team for creating NUnit and continuing to support it. NUnit was one of the first frameworks as a young developer.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- NUnit (>= 3.0.0 && < 4.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.