StaticDictionaries 1.0.0-rc

StaticDictionaries 📚

Simple high performance solution for data hardcoding. Smart. Flexible. Powerful.

Powered by source generators. Without using reflection.

StaticDictionaries is a convinient library for data hardcoding in your project. Just decorate the enum using attributes, the source generator will do the rest for you. Minimum code and time spent - maximum result and performance. Property management has never been so convenient. Generated methods for managing enum without reflection will make development pleasant and faster than ever.

Installing StaticDictionaries

StaticDictionaries is available on NuGet.

dotnet add package StaticDictionaries

Install-Package StaticDictionaries

Basic usage by steps🛸

1. Decorate your enum with [StaticDictionary] attribute and define arguments to generate properties:

[StaticDictionary("Surname", "Age")]
public enum User

2. Decorate your enum members with [Value] attribute and define member values:

[Value("Brown", 27)]
John = 1

3. Build project to run source generator and get access to generated methods:

int age = User.John.Age();

Powerful enum management 🦾

Source generator creates some methods in [EnumName]Extensions class for convenient and fast enum management:

• Length quantity of all enum members.
• MinId returns min Id().
• MaxId returns max Id().
• All() returns an array of all enum members.
• GetById() returns member or NotSupportedException.

Dictionary supported primitive types 🗿

Samples 🤝

Employee dictionary with Name, Age and Active properties:

[StaticDictionary("Name", "Age", "Active")]
public enum Employee
{
    [Value("Maxim Jhonson", 18, true)]
    Maxim = 1,
    [Value("John Jhonson", 23, false)]
    John = 2
}

public static void Main()
{
    int johnAge = Employee.John.Age();
    int maximAge = Employee.Maxim.Age();
    
    string johnName = Employee.John.Name();
    string maximName = Employee.Maxim.Name();
}

Source generator creates [EnumName]Extensions class that provide some powerful functionality for managing your enum:

[StaticDictionary("Name", "IsLast")]
public enum Status
{
    [Value("New state", false)]
    New = 1,
    [Value("In progress", false)]
    InProgress = 2,
    [Value("In progress", true)]
    Completed = 3
}

public static void Main()
{
    Status status = StatusExtensions.GetById(2);
    
    Status[] statuses = StatusExtensions
                      .All()
                      .Where(x => !x.IsLast())
                      .ToArray();
}

Id() and Name() methods are generated by default if you do not override them.

[StaticDictionary]
public enum Metal
{
    [Value]
    Gold = 1,
    [Value]
    Ferrum = 2
}

public static void Main()
{
    int goldId = Metal.Gold.Id(); 
    string ferrumName = Metal.Ferrum.Name();
}

Important notes ⚠️

• [StaticDictionary] parameter names must not be duplicated.
• [StaticDictionary] parameter names must use the English alphabet only because they will be generated into methods.
• All [Value] attrubutes must contain such arguments quantity as [StaticDictionary].
• All [StaticDictionary] enum members must contain [Value] attribute with arguments.
• Generator creates two methods by default: Id() with (int)member and Name() with nameof(member) if you do not override them.
• enum members without [Value] attribute will be ignored.
• Parameter types are determined automatically, so all parameters in a sequence must be of the same type. For example, all of the first types should be string, and all of the second types should be bool.