CodeChops.MagicEnums 1.1.0

Flexible and extendable enums for C#:

• It is possible to use other member values than integral types. For example:

  • Strings that automatically represent their member name:
    • This prohibits incorrect usage of integral values when they are not needed;
    • It removes the need to keep track of (incremental) integral values;
  • Custom defined types, for example see StrictDirection: https://github.com/Code-Chops/Geometry/;

• Inheritance and/or partial records can be used to extend your enums:

  • Enums can now be extended in multiple projects;
  • Custom methods can be added to enums, if necessary;

• Enum-members can be auto-discovered. This removes the need to keep track of used/unused enum-members:

  • Explicitly:
    • Is enabled by adding the DiscoverableEnumMembers-attribute;
    • Use {Enum}.{Member}.CreateMember(...) to create a source generated enum-member on the fly;
    • A member value (and comment) can be provided;
  • Implicitly:
    • Is enabled by adding the DiscoverableEnumMembers-attribute with implicitDiscoverability = true;
    • Use {Enum}.{Member} to create a source generated enum-member on the fly;

• Enum members can be added at runtime, if necessary;

• Has the same functionality as the default .NET enum:

  • Members can be found by using their name or value;
  • Multiple members with the same value can even be looked up: This is not supported in default C# enums;

• Optimized, and therefore fast member registration / lookup;