Soenneker.Gen.EnumValues 4.0.2

Soenneker.Gen.EnumValues

Compile-time generated enum values. Zero reflection. Zero allocations.

Generate value objects with fast lookup APIs, switch-friendly constants, and built-in JSON serialization (System.Text.Json/Newtonsoft.Json).

Installation

dotnet add package Soenneker.Gen.EnumValues

Usage

Annotate a partial type with [EnumValue] (defaults to int) or [EnumValue<T>]:

using Soenneker.Gen.EnumValues;

[EnumValue]
public sealed partial class OrderStatus
{
    public static readonly OrderStatus Pending = new(1);
    public static readonly OrderStatus Completed = new(2);
}

using Soenneker.Gen.EnumValues;

[EnumValue<string>]
public sealed partial class ColorCode
{
    public static readonly ColorCode Red = new("R");
    public static readonly ColorCode Blue = new("B");
}

The generator emits:

• List
• <MemberName>Value constants (for constant-friendly switch labels)
• TryFromValue(TValue value, out TEnum result)
• FromValue(TValue value)
• TryFromName(string name, out TEnum result)
• FromName(string name)

Lookups

if (OrderStatus.TryFromValue(1, out var pending))
{
    // pending == OrderStatus.Pending
}

var completed = OrderStatus.FromValue(2);

if (ColorCode.TryFromName("Red", out var red))
{
    // red == ColorCode.Red
}

Switching over values

Switch labels must be compile-time constants. The generator emits <MemberName>Value constants so you can switch efficiently on Value:

switch (orderStatus.Value)
{
    case OrderStatus.PendingValue:
        // ...
        break;
    case OrderStatus.CompletedValue:
        // ...
        break;
}

If your variable is already the raw value type (int, string, etc.), you can switch directly on that variable with the same constants.

Serialization

System.Text.Json is always supported and the converter is applied automatically.

Newtonsoft.Json is also supported automatically when your project references Newtonsoft.Json:

dotnet add package Newtonsoft.Json

After that, both serializers round-trip by Value.

Value and the value constructor are generated automatically if they do not already exist.

Notes

• The enum type must be partial.
• Top-level non-generic class/struct types are supported.
• Static instances must be initialized with a compile-time constant first constructor argument.
• <MemberName>Value constants are emitted for const-compatible value types (for example: numeric types, string, char, bool).