Dev.Util.Core 1.2.2

Dev.Util.Core

The foundation of the Dev.Util ecosystem. This package provides high-performance extension methods, robust guard clauses, and essential utilities for every .NET project.

📦 Installation

dotnet add package Dev.Util.Core

✨ Features

• 🛡️ Guard Clauses: Bulletproof argument validation to prevent invalid state.
• 🔡 String Utilities: Humanizers, slugify, conversion, masking, and privacy helpers.
• 📅 Date/Time: Business days, age calculation, relative time (e.g., "5 mins ago").
• 📑 Enums: Retrieve user-friendly descriptions from [Description] attributes.
• 🔢 Numeric: Semantic range checking and percentage calculations.
• 🧩 Object Extensions: Fluent null checking and property access.

🛠 Usage Examples

1. Guard Clauses

Eliminate boilerplate null and range checks at the start of your methods.

using Dev.Util.Core;

public void register_user(string username, int age, string email)
{
    // Basic checks
    Guard.Against.NullOrWhiteSpace(username, nameof(username));
    Guard.Against.NegativeOrZero(age, nameof(age));
    
    // Custom conditions
    Guard.Against.Condition(age < 18, nameof(age), "Minors cannot register.");
    
    // Email format (if using with Dev.Util.Web)
    Guard.Against.InvalidEmail(email, nameof(email));
}

2. Advanced String Manipulation

From privacy masking to URL-friendly slugs.

using Dev.Util.Core;

// Privacy: Mask sensitive data
"1234567890".Mask(4); // "1234******"
"secret@example.com".Mask(2); // "se****************"

// Humanizer
"calculate_total_price".ToTitleCase(); // "Calculate Total Price"

// URL Slugs
"How to use Dev.Util in 2024!".Slugify(); // "how-to-use-dev-util-in-2024"

// Metrics
"This is a long sentence.".WordCount(); // 5
"This article takes about 1000 words...".ReadingTimeInMinutes(); // ~4

3. Date & Time Intelligence

Business logic for dates made simple.

using Dev.Util.Core;

DateTime dob = new DateTime(1995, 5, 10);
int age = dob.CalculateAge(); // 29

// Relative Time
DateTime past = DateTime.Now.AddMinutes(-5);
string text = past.ToRelativeTime(); // "5 minutes ago"

// Business Days
DateTime delivery = DateTime.Now.AddBusinessDays(3); // Skips weekends

4. Semantic Numeric Ranges

Write clearer logic for bounds checking.

using Dev.Util.Core;

double score = 85.5;

if (score.InRange(0, 100)) 
{
    Console.WriteLine("Valid Grade");
}

int items = 10;
double tax = items.PercentOf(15); // 1.5

5. Enum metadata

Map technical enums to UI-friendly strings.

public enum OrderStatus {
    [Description("Order is Pending")]
    Pending,
    [Description("Shipped to Customer")]
    Shipped
}

string label = OrderStatus.Pending.GetDescription(); // "Order is Pending"