Philiprehberger.DeepClone

Fast deep cloning using compiled expression trees for nested objects, collections, and circular references.

Installation

dotnet add package Philiprehberger.DeepClone

Usage

Basic Cloning

using Philiprehberger.DeepClone;

var original = new Person { Name = "Alice", Age = 30 };
var clone = DeepClone.Clone(original);

// Or use the extension method
var clone2 = original.DeepClone();

Nested Objects and Collections

var team = new Team
{
    Name = "Engineering",
    Members = new List<Person>
    {
        new() { Name = "Alice", Age = 30 },
        new() { Name = "Bob", Age = 25 }
    }
};

var clonedTeam = team.DeepClone();
clonedTeam.Members[0].Name = "Charlie";
// original.Members[0].Name is still "Alice"

Clone with Property Overrides

var original = new Person { Name = "Alice", Age = 30 };
var modified = DeepClone.CloneWith(original, p => p.Name = "Bob");
// modified.Name is "Bob", modified.Age is 30
// original.Name is still "Alice"

// Or use the extension method
var modified2 = original.DeepCloneWith(p => p.Age = 25);

Circular References

var node = new TreeNode { Value = "root" };
node.Children.Add(new TreeNode { Value = "child", Parent = node });

// Circular references are handled automatically
var clonedTree = node.DeepClone();

API

DeepClone

Method	Description
Clone<T>(T obj)	Create a deep clone of the given object
CloneWith<T>(T obj, Action<T> configure)	Deep clone then apply property overrides

Extension Methods

Method	Description
DeepClone<T>(this T obj)	Extension method for deep cloning any object
DeepCloneWith<T>(this T obj, Action<T> configure)	Extension method for deep cloning with property overrides

Supported Types

Type	Behavior
Primitives	Passed through (value types)
string	Passed through (immutable)
Arrays	Element-wise deep clone
List<T>	Element-wise deep clone
Dictionary<K, V>	Key/value deep clone
Classes	Property-by-property deep clone
Structs	Property-by-property deep clone

Development

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

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT