Dev.Util.Core 1.0.1

Dev.Util.Core

The foundation of the Dev.Util ecosystem. This package provides essential extension methods, guard clauses, and utilities that every .NET developer needs.

📦 Installation

dotnet add package Dev.Util.Core

✨ Features

• Guard Clauses: Fluent argument validation.
• String Extensions: Humanizers, slugify, conversion.
• DateTime Extensions: Business days, age calculation, relative time.
• Object Extensions: Fluent null checking.
• Validation: Email, phone, and credit card validation.

🛠 Usage Examples

1. Guard Clauses

Stop writing repetitive if (arg == null) throw ... checks. Use fluent guards instead.

using Dev.Util.Core;

public void CreateUser(string username, int age, List<string> roles)
{
    // Throws ArgumentNullException / ArgumentException / ArgumentOutOfRangeException
    Guard.Against.NullOrWhiteSpace(username, nameof(username));
    Guard.Against.NegativeOrZero(age, nameof(age));
    Guard.Against.NullOrEmpty(roles, nameof(roles));

    // Custom condition
    Guard.Against.Condition(age < 18, nameof(age), "User must be 18+");
}

2. String Manipulation

Make your strings human-readable and URL-friendly.

using Dev.Util.Core;

string title = "Hello World: This is a test!";

// Slugify for URLs
var slug = title.Slugify(); 
// Output: "hello-world-this-is-a-test"

// Truncate text
var summary = title.Truncate(10); 
// Output: "Hello Worl..."

// Humanize Title Case
var properlyCased = "mr. john doe".ToTitleCase();
// Output: "Mr. John Doe"

// Word Count & Reading Time
int words = "Long article text...".WordCount();
int minutesToRead = "Long article text...".ReadingTimeInMinutes();

// Safe Conversion
int number = "123".ToInt();
int? safeNumber = "abc".ToIntOrNull(); // null

3. Date & Time

Simplify date logic with business day and relative time helpers.

using Dev.Util.Core;

var dob = new DateTime(1990, 5, 20);
int age = dob.ToAge(); 
// Output: 34 (depending on today)

// Relative Time
var postTime = DateTime.Now.AddMinutes(-5);
Console.WriteLine(postTime.ToRelativeTime()); 
// Output: "5 minutes ago"

// Business Days via Extensions
var friday = new DateTime(2023, 10, 27);
var nextBusinessDay = friday.AddBusinessDays(1); 
// Skips Sat/Sun -> Monday 2023-10-30

bool isWeekend = DateTime.Now.IsWeekend();

4. Validation

Quickly validate common data formats.

using Dev.Util.Core;

bool isValidEmail = "test@example.com".IsValidEmail();
bool isCreditCard = "4111...".IsValidCreditCard(); // basic Luhn check
bool isUrl = "https://google.com".IsValidUrl();