Philiprehberger.ObjectDiff 0.2.0

Philiprehberger.ObjectDiff

Compare two objects and return a list of property-level changes.

Installation

dotnet add package Philiprehberger.ObjectDiff

Usage

using Philiprehberger.ObjectDiff;

var old = new User { Name = "Alice", Email = "alice@old.com" };
var updated = new User { Name = "Alice", Email = "alice@new.com" };

var result = ObjectDiff.Compare(old, updated);

foreach (var change in result.Changes)
    Console.WriteLine($"{change.PropertyName}: {change.OldValue} -> {change.NewValue}");
// Email: alice@old.com -> alice@new.com

Ignore properties

var options = new DiffOptions();
options.IgnoreProperties.Add("UpdatedAt");

var result = ObjectDiff.Compare(old, updated, options);

DiffIgnore attribute

using Philiprehberger.ObjectDiff;

public class AuditEntry
{
    public string Action { get; set; } = "";

    [DiffIgnore]
    public DateTime Timestamp { get; set; }
}

var result = ObjectDiff.Compare(oldEntry, newEntry);
// Timestamp is excluded from comparison

Deep compare (nested objects)

var options = new DiffOptions { DeepCompare = true, MaxDepth = 3 };

var result = ObjectDiff.Compare(oldOrder, newOrder, options);
// Changes include nested paths like "Address.City"

Collection diffing

using Philiprehberger.ObjectDiff;

var old = new Order { Tags = new List<string> { "urgent", "review" } };
var updated = new Order { Tags = new List<string> { "urgent", "approved" } };

var result = ObjectDiff.Compare(old, updated);
// Tags[1] changed from "review" to "approved"

Dictionary diffing

using Philiprehberger.ObjectDiff;

var old = new Config { Settings = new Dictionary<string, string> { ["theme"] = "dark" } };
var updated = new Config { Settings = new Dictionary<string, string> { ["theme"] = "light", ["lang"] = "en" } };

var result = ObjectDiff.Compare(old, updated);
// Settings[theme] changed from "dark" to "light"
// Settings[lang] added with value "en"

Human-readable summaries

using Philiprehberger.ObjectDiff;

var result = ObjectDiff.Compare(old, updated);
IReadOnlyList<string> summary = result.GetSummary();

foreach (var line in summary)
    Console.WriteLine(line);
// Name changed from 'Alice' to 'Bob'
// Email changed from 'alice@old.com' to 'alice@new.com'

Serialize to JSON (audit logging)

var result = ObjectDiff.Compare(old, updated);
string json = ObjectDiff.ToJson(result);
// {
//   "changes": [
//     {
//       "property": "Email",
//       "old": "alice@old.com",
//       "new": "alice@new.com"
//     }
//   ]
// }

API

Development

dotnet build src/Philiprehberger.ObjectDiff.csproj --configuration Release

Support

If you find this package useful, consider giving it a star on GitHub — it helps motivate continued maintenance and development.

License

MIT