BrainEnterprise.Core.Enums 10.0.0

BrainEnterprise.Core.Enums

Libreria di utilit per la gestione degli Enum in .NET. Fornisce helper per descrizioni leggibili, conversione in DataTable/List, metadata UI, raggruppamento, extension methods e gestione completa delle transizioni di stato.

Target Framework

• .NET Standard 2.0
• .NET Framework 4.6.2
• .NET 9

Installazione

dotnet add package BrainEnterprise.Core.Enums

Classi principali

Utilizzo

Enum di esempio

using System.ComponentModel;
using BrainEnterprise.Core.Enums;
using BrainEnterprise.Core.Enums.Transitions;

public enum OrderStatus
{
    [Description("In attesa di pagamento")]
    [EnumMetadata(Color = "#FFA500", Icon = "hourglass", CssClass = "badge-warning")]
    [EnumGroup("Attivi")]
    [AllowedTransitions((int)Confirmed, (int)Cancelled)]
    Pending = 0,

    [Description("Confermato")]
    [EnumMetadata(Color = "#007BFF", Icon = "check", CssClass = "badge-info")]
    [EnumGroup("Attivi")]
    [AllowedTransitions((int)Shipped, (int)Cancelled)]
    Confirmed = 1,

    [Description("Spedito")]
    [EnumMetadata(Color = "#17A2B8", Icon = "truck", CssClass = "badge-primary")]
    [EnumGroup("Attivi")]
    [AllowedTransitions((int)Delivered)]
    Shipped = 2,

    [Description("Consegnato")]
    [EnumMetadata(Color = "#28A745", Icon = "package", CssClass = "badge-success")]
    [EnumGroup("Chiusi")]
    Delivered = 3,

    [Description("Annullato")]
    [EnumMetadata(Color = "#DC3545", Icon = "x-circle", CssClass = "badge-danger", IsActive = false)]
    [EnumGroup("Chiusi")]
    Cancelled = 4
}

ToDataTable / ToList

using BrainEnterprise.Core.Enums;

DataTable table = EnumHelper.ToDataTable<OrderStatus>();
// Id | Description
// 0  | In attesa di pagamento
// 1  | Confermato
// ...

List<EnumHelper.EnumItem> items = EnumHelper.ToList<OrderStatus>();
// [{ Id = 0, Description = "In attesa di pagamento" }, ...]

Extension methods

using BrainEnterprise.Core.Enums.Extensions;

OrderStatus status = OrderStatus.Pending;

string desc = status.ToDescription();  // "In attesa di pagamento"
string color = status.ToColor();       // "#FFA500"

Transizioni di stato con attributi

StatusTransitionHelper utilizza AllowedTransitionsAttribute per validare le transizioni.

using BrainEnterprise.Core.Enums.Transitions;

// Verifica se una transizione  consentita
bool ok = StatusTransitionHelper.CanTransition(OrderStatus.Pending, OrderStatus.Confirmed);   // true
bool ko = StatusTransitionHelper.CanTransition(OrderStatus.Pending, OrderStatus.Delivered);    // false

// Esegue la transizione o lancia InvalidOperationException
var next = StatusTransitionHelper.Transition(OrderStatus.Pending, OrderStatus.Confirmed);

// Ottiene gli stati raggiungibili
var allowed = StatusTransitionHelper.GetAllowedNextStatuses(OrderStatus.Pending);
// [{ Id = 1, Description = "Confermato" }, { Id = 4, Description = "Annullato" }]

State machine configurabile

StatusMachine<TEnum> permette di definire transizioni a runtime con API fluent, supportando condizioni opzionali.

using BrainEnterprise.Core.Enums.Transitions;

var machine = new StatusMachine<OrderStatus>()
    .Allow(OrderStatus.Pending, OrderStatus.Confirmed, "Conferma ordine")
    .Allow(OrderStatus.Pending, OrderStatus.Cancelled, "Annullamento")
    .Allow(OrderStatus.Confirmed, OrderStatus.Shipped, "Spedizione")
    .Allow(OrderStatus.Confirmed, OrderStatus.Cancelled, "Annullamento post-conferma")
    .Allow(OrderStatus.Shipped, OrderStatus.Delivered, "Consegna avvenuta");

// Verifica transizione
bool canShip = machine.CanTransition(OrderStatus.Confirmed, OrderStatus.Shipped); // true

// Stati raggiungibili
var nextStates = machine.GetAllowedNextStates(OrderStatus.Confirmed);
// [{ Id = 2, Description = "Spedito" }, { Id = 4, Description = "Annullato" }]

// Transizione condizionale
bool isPaid = true;
var conditionalMachine = new StatusMachine<OrderStatus>()
    .Allow(OrderStatus.Pending, OrderStatus.Confirmed,
           "Conferma solo se pagato",
           condition: () => isPaid);

Licenza

MIT - 2026 Brain Enterprise S.r.l.