Casper.Library 1.0.2

Casper.Library

A utility library for .NET applications providing helpful extensions and attributes for common development tasks.

Features

Enum Extensions

• GetCode() - Retrieve custom codes from enum values using DescriptionAttribute
• GetDescription() - Get descriptions from enum values using DescriptionAttribute
• ToEnum<T>() - Convert strings to enum values with support for:
  • Numeric values
  • Enum names (case-insensitive)
  • Custom codes from DescriptionAttribute

Number Extensions

• ToDecimalDefault() - Convert nullable decimals, doubles, and strings to decimal with default fallback
• ToLongDefault() - Convert nullable longs to long with default fallback
• ToDoubleDefault() - Convert nullable numbers to double with default fallback
• ToIntDefault() - Convert nullable numbers to int with default fallback

Custom Attributes

• DescriptionAttribute - Add custom codes, descriptions, types, and names to enum values
• PermisionAttribute - Define permission-based access control with service, group, and permission hierarchies

Installation

dotnet add package Casper.Library

Usage

Enum Extensions

using Casper.Library.Helpers.Extensions;
using Casper.Library.Helpers.Attributes;

public enum Status
{
    [Description(Code = "ACT", Description = "Active")]
    Active,
    
    [Description(Code = "INA", Description = "Inactive")]
    Inactive
}

// Get custom code
string code = Status.Active.GetCode(); // Returns "ACT"

// Get description
string description = Status.Active.GetDescription(); // Returns "Active"

// Convert string to enum
Status status = "ACT".ToEnum<Status>(); // Returns Status.Active

Number Extensions

using Casper.Library.Helpers.Extensions;

// Convert nullable numbers with default fallback
decimal? nullableDecimal = null;
decimal result = nullableDecimal.ToDecimalDefault(); // Returns 0

// Convert string to decimal with culture support
string numberString = "123.45";
decimal decimalValue = numberString.ToDecimalDefault("en-US"); // Returns 123.45

Permission Attribute

using Casper.Library.Helpers.Attributes;

[Permision(
    ServiceCode = "USER",
    ServiceName = "User Management",
    GroupCode = "ADMIN",
    GroupName = "Administration",
    PermisionCode = "CREATE",
    PermisionName = "Create User",
    Description = "Allows creating new users"
)]
public class UserController
{
    // Controller implementation
}

Requirements

• .NET 8.0 or later

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.