ObjDiff

A C# .NET Standard library that allows to check for equality and obtain the differences between two objects using reflection. The comparison process can be configured in many ways so, e.g., it can ignore certain properties.

Optionally, these differences can be used to patch the first object so it becomes equal to the second one. This patching feature is specially useful when updating Entity Framework entities as it allows to atomically update only those properties that have really changed.

Installation

Using .NET CLI:

dotnet add package ObjDiff

Using NuGet package manager console:

Install-Package ObjDiff

Features

• Compares arrays and collections.
• Compares children objects.
• Configuration options to ignore specific elements.
• Patch an object with an obtained set of differences.

Limitations

• Only allows to compare objects of the same type.
• Only public properties are compared.

Usage

Obtaining Differences

usingObjDiff;varobject1=newCustomObject();varobject2=newCustomObject();IEnumerable<Difference>differences=ObjDiff.Diff(object1,object2);

The last line can also be expressed through the use of the Diff extension method:

IEnumerable<Difference>differences=object1.Diff(object2);

The Diff method returns a list with all the differences found between object1 and object2 instances. Each one of these differences are represented through an instance of the Difference class:

publicclassDifference{/// Full path of the element were values differ between compared objects.publicstringPath{get;privateset;}/// Value of the object being compared.publicobjectLeftValue{get;privateset;}/// Value of the object against LeftValue is being compared.publicobjectRightValue{get;privateset;}}

Comparison Options

It is possible to customize how the comparison process will perform:

vardifferences=object1.Diff(object2,newCompareOptions{MaxDepth=10});

The available options are:

publicclassCompareOptions{/// When comparing arrays/collections, items must be in the same order. Default value is true.publicboolCollectionsSameOrder{get;set;}/// Ignore properties marked with any of the specified attribute names. None set by default.publicstring[]IgnoredAttributes{get;set;}/// Ignore properties named with any of the specified values. None set by default.publicstring[]IgnoredProperties{get;set;}/// Don't dive into any property named with any of the specified values. None set by default.publicstring[]DontDiveProperties{get;set;}/// Maximum number of children levels to dive into. Default value is 10.publicuintMaxDepth{get;set;}}

Ignoring Properties

Any property marked with the IgnoreDifferences attribute will always be skipped during the comparison process, no matter the actual value of the IgnoredAttributes property if CompareOptions is used.

publicclassSampleClass{[IgnoreDifferences]publicstringSampleProperty{get;set;}}

Patching

Once we have the differences between two objects, we can apply them (patch) to the original object being compared. After patching it, both objects should be equivalent.

object1.Patch(differences);Assert.Equal(object1,object2);

Both Diff and Patch operations can be executed through a simple call:

ObjDiff.MakeEqual(object1,object2,compareOptions);

Or using MakeEqualTo extension method:

object1.MakeEqualTo(object2,compareOptions);

Checking Equality

The library also offers a method to easily check that two objects are equal (attending to ObjDiff rules):

ObjDiff.AreEqual(object1,object2,compareOptions);

Or using IsEqualTo extension method:

object1.IsEqualTo(object2,compareOptions);