DeepCloneGenerator.Generator
0.7.6
dotnet add package DeepCloneGenerator.Generator --version 0.7.6
NuGet\Install-Package DeepCloneGenerator.Generator -Version 0.7.6
<PackageReference Include="DeepCloneGenerator.Generator" Version="0.7.6" />
<PackageVersion Include="DeepCloneGenerator.Generator" Version="0.7.6" />
<PackageReference Include="DeepCloneGenerator.Generator" />
paket add DeepCloneGenerator.Generator --version 0.7.6
#r "nuget: DeepCloneGenerator.Generator, 0.7.6"
#:package DeepCloneGenerator.Generator@0.7.6
#addin nuget:?package=DeepCloneGenerator.Generator&version=0.7.6
#tool nuget:?package=DeepCloneGenerator.Generator&version=0.7.6
Deep clone generator
Deep clone generator is a library that utilizes source generator to generate a DeepClone()
method which clones classes
by its values.
Usage
- Install package using
dotnet add DeepCloneGenerator
- Add the
[GenerateDeepClone]
attribute on top of apartial class
that you want to generate aDeepClone()
method for - Done! You now have a
DeepClone()
method
Supported type members
The following type members are supported:
- Fields
- required Fields
- Properties
- required Properties
Supported types
The following types are supported for deep cloning:
- Any class annotated with
[GenerateDeepClone]
- Any built-in value type
- Any concrete class which implements
ICollection<T>
and has a parameterless ctor (likeList<T>
andHashSet<T>
) - Any
IEnumerable<T>
(the clone will have a List<T> with the values of the original cloned) - Any concrete class which implements
IDictionary<T, V>
and has a parameterless ctor (likeDictionary<T, V>
) - Any struct
- Any record
Known limitations
- When collections are made with certain characteristics, those characteristics are currently lost (e.g.: an EqualityComparer for a Dictionary)
- Classes with primary constructors are not yet supported
Future plans
- Add analyzers which will inform of known limitations as warnings when DeepClone functionality is not working as intended
Requests
There are many many more scenarios in which people can structure classes/structs. I intend to cover them all but my imagination has his limits.
Feel free to submit issues when one of the more exotic situations are not supported and I'll see if the library can support it.
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- Microsoft.CodeAnalysis.CSharp (>= 4.3.0)
- Microsoft.CodeAnalysis.CSharp.Workspaces (>= 4.3.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on DeepCloneGenerator.Generator:
Package | Downloads |
---|---|
DeepCloneGenerator
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.