A set of source generators for equality, immutability, ...
Перейти к файлу
beppemarazzi c245fa5fc6 System.ComponentModel.DataAnnotations.KeyAttribute is not mandatory 2020-01-07 08:30:31 +01:00
.github Update GitHub templates and added documentation files. 2018-10-31 14:09:42 -04:00
build Should work better with .gitpod at the right place 2019-11-04 03:53:43 +00:00
doc Update Equality Generation.md 2019-12-11 08:27:29 -05:00
src System.ComponentModel.DataAnnotations.KeyAttribute is not mandatory 2020-01-07 08:30:31 +01:00
.editorconfig Fixed missing "global::" for attributes on builder 2018-08-21 16:34:08 -04:00
.gitattributes Initial push 2018-02-02 01:23:14 -05:00
.gitignore Add github PR and issue templates for Uno.CodeGen 2018-10-29 12:41:13 -04:00
.gitpod.yml Should work better with .gitpod at the right place 2019-11-04 03:53:43 +00:00
.vsts-ci.yml Run tests in CI 2020-01-03 13:23:30 -05:00
CODE_OF_CONDUCT.md Update GitHub templates and added documentation files. 2018-10-31 14:09:42 -04:00
CONTRIBUTING.md Update GitHub templates and added documentation files. 2018-10-31 14:09:42 -04:00
License.md Initial push 2018-02-02 01:23:14 -05:00
gitversion.yml fixed gitversion 2019-07-10 12:45:00 -04:00
readme.md Remove old stuff from Readme 2019-02-16 15:44:02 -05:00

readme.md

Uno CodeGen

Uno.CodeGen is a set of tools to generate C# code in msbuild based projects.

Generate Equality Members for your C# classes

Equality Members generation snippet

Features:

  • Amazingly fast: absolutely zero reflection at runtime
  • Generates both .Equals() and .GetHashCode() overrrides
  • Generates equality (== and !=) operators
  • Implements IEquatable<T>
  • Works with derived classes
  • Custom comparers supported
  • Works with collection members (both same order and unsorted equality)
  • Works with dictionary members (both same order and unsorted equality)
  • Optional case insentive comparisons for strings
  • Optional support for KeyEquality (see doc for more details)
  • Debuggable: You can put a breakpoint directly in the generated code
  • Highly configureable: Generated code provides a lot of useful tips (stripped in previous snippet)
  • Documentation here for Equality Members Generator

Create truly Immutable Entities in C#

Equality Members generation snippet

Features:

  • Automatic Null object pattern generation
  • Automatic generation of <YourClass>.Builder nested class
  • Fluent .With<field/property name>() generation of every members of your class
  • Amazingly fast: absolutely zero reflection at runtime
  • Works with generics & derived classes (even if they are from external assembly)
  • Optional support (on by default) for [GeneratedEquality]
  • Transparent support for Newtonsoft's JSON.NET (activated when detected, can be turned off)
  • Debuggable: You can put a breakpoint directly in the generated code
  • Validation to avoid mutable code in your class
  • Highly configureable: Generated code provides a lot of useful tips (stripped in previous snippet)
  • Documentation here for Immutable Entities Generator

Available Generators

Generator Triggering Attributes Usage
ClassLifecycleGenerator [ConstructorMethod] [DisposeMethod] [FinalizerMethod] Generate code to extend the lifecyle of a class. Documentation
CompilationReferencesListingGenerator none Generate a file without useful code, containing only comments detailing references used to compile the project. Documentation
EqualityGenerator [GenerateEquality] Generate code for efficient .Equals() members generation. Documentation
ImmutableGenerator [GenerateImmutable] Generate code to build truly immutable entities. Documentation
InjectableGenerator [Inject] Generate code to resolve and inject dependencies. Documentation

Nuget

NuGet

FAQ

Read our FAQ here

Have questions? Feature requests? Issues?

Make sure to visit our FAQ, StackOverflow, create an issue or visit our gitter.

Contributing

Read our contributing guide to learn about our development process and how to propose bug fixes and improvements.