SaturdayMP.NConstraints 1.1.1

dotnet add package SaturdayMP.NConstraints --version 1.1.1                
NuGet\Install-Package SaturdayMP.NConstraints -Version 1.1.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SaturdayMP.NConstraints" Version="1.1.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SaturdayMP.NConstraints --version 1.1.1                
#r "nuget: SaturdayMP.NConstraints, 1.1.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// 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                

CI/CD Release Notes

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:

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .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.

Version Downloads Last updated
1.1.1 183 7/19/2023
1.1.0 177 7/18/2023
1.0.0 1,039 10/16/2017