Beskar.CodeGeneration.EnumGenerator 1.2.1

Beskar.CodeGeneration.EnumGenerator

Beskar.CodeGeneration.EnumGenerator is a high-performance C# source generator that creates efficient extension methods for your enums. It eliminates the overhead of reflection-based operations like ToString(), Enum.Parse(), and Enum.IsDefined().

✨ Key Features

• Performance: Zero-reflection ToString() and parsing replacements.
• Modern C#: Utilizes latest language features like switch expressions and collection expressions.
• Utility Methods: Easy access to all values and names without Enum.GetValues.
• Lightweight: Only generates what you need for the marked enums.

🚀 Getting Started

To enable generation for an enum, simply decorate it with the [FastEnum] attribute.

Example

using Beskar.CodeGeneration.EnumGenerator.Marker.Attributes;

namespace MyProject;

[FastEnum]
public enum UserRole
{
    Admin,
    Moderator,
    User,
    Guest
}

🛠 Generated Output

The generator will produce a partial class containing optimized extension methods using the extension syntax:

#nullable enable

// <auto-generated>
// This file is auto-generated by EnumGenerator[1.2.1].
// </auto-generated>

using System;

namespace MyProject;

public static partial class UserRoleExtensions
{
   extension(global::MyProject.UserRole value)
   {
      public static int ValueCount => 4;

      public static global::MyProject.UserRole[] GetAllValues() => [
         global::MyProject.UserRole.Admin,
         global::MyProject.UserRole.Moderator,
         global::MyProject.UserRole.User,
         global::MyProject.UserRole.Guest,
      ];

      public static string[] GetAllNames() => [
         nameof(global::MyProject.UserRole.Admin),
         nameof(global::MyProject.UserRole.Moderator),
         nameof(global::MyProject.UserRole.User),
         nameof(global::MyProject.UserRole.Guest),
      ];

      public string ToFastString()
      {
         return value switch
         {
            global::MyProject.UserRole.Admin => nameof(global::MyProject.UserRole.Admin),
            global::MyProject.UserRole.Moderator => nameof(global::MyProject.UserRole.Moderator),
            global::MyProject.UserRole.User => nameof(global::MyProject.UserRole.User),
            global::MyProject.UserRole.Guest => nameof(global::MyProject.UserRole.Guest),
            _ => value.ToString()
         };
      }

      public bool IsFastDefined()
      {
         return value switch
         {
            global::MyProject.UserRole.Admin => true,
            global::MyProject.UserRole.Moderator => true,
            global::MyProject.UserRole.User => true,
            global::MyProject.UserRole.Guest => true,
            _ => false
         };
      }

      public static bool TryFastParseExact(string? name, out global::MyProject.UserRole result)
      {
         switch (name)
         {
            case nameof(global::MyProject.UserRole.Admin):
               result = global::MyProject.UserRole.Admin;
               return true;
            case nameof(global::MyProject.UserRole.Moderator):
               result = global::MyProject.UserRole.Moderator;
               return true;
            case nameof(global::MyProject.UserRole.User):
               result = global::MyProject.UserRole.User;
               return true;
            case nameof(global::MyProject.UserRole.Guest):
               result = global::MyProject.UserRole.Guest;
               return true;
            default:
               result = default;
               return false;
         };
      }

      public static bool TryFastParseCase(string? name, out global::MyProject.UserRole result, StringComparison comparisonType = StringComparison.OrdinalIgnoreCase)
      {
         switch (name)
         {
            case string str when str.Equals(nameof(global::MyProject.UserRole.Admin), comparisonType):
               result = global::MyProject.UserRole.Admin;
               return true;
            case string str when str.Equals(nameof(global::MyProject.UserRole.Moderator), comparisonType):
               result = global::MyProject.UserRole.Moderator;
               return true;
            case string str when str.Equals(nameof(global::MyProject.UserRole.User), comparisonType):
               result = global::MyProject.UserRole.User;
               return true;
            case string str when str.Equals(nameof(global::MyProject.UserRole.Guest), comparisonType):
               result = global::MyProject.UserRole.Guest;
               return true;
            default:
               result = default;
               return false;
         };
      }
   }
}