Aicrosoft.Extensions 8.0.0-beta.260130.2

Aicrosoft.Extensions

Aicrosoft.Extensions is a comprehensive utility library that provides a wide range of extension methods and helper classes to simplify common tasks in .NET development. It aims to reduce boilerplate code and improve developer productivity by extending the capabilities of the standard .NET system types.

Design Goals

1. Reduce Redundant Code: Centrally implement frequently used functions like string manipulation, IO operations, and JSON transformation to avoid reinventing the wheel in every project.
2. Enhance Native Types: Inject practical methods into native types such as string, DateTime, Enum, and List, making code cleaner and more readable.
3. Fluent Parameter Validation: Provide a Check class for elegant defensive programming through fluent argument validation.
4. Broad Compatibility: Support .NET Standard 2.0, .NET Framework 4.6.2, and .NET 8.0, ensuring seamless usage in both legacy systems and modern applications.
5. Built-in Utilities: Include lightweight versions of caching (ICache), console progress bars, file locking mechanisms, and other tools commonly needed during development.

Core Features

1. System Type Extensions (System)

• String: Truncate, ToCamelCase, ToMd5, ToEnum, Left/Right manipulation, and more.
• Collections: IsNullOrEmpty checks, ForEach iterators, and dictionary merging.
• DateTime: Human-readable time displays, customized formatting, and period calculations.
• Object: ToJson (easy serialization), As<T> (safe casting), and property copying.

2. Parameter Validation (Check)

A concise API for validating method arguments:

• Check.NotNull(obj): Validates that an object is not null.
• Check.NotNullOrEmpty(str): Validates that a string is neither null nor empty.
• Check.Length(str, max, min): Validates that a string's length is within a specified range.

3. Data Processing (System.Text, System.Xml)

• JSON Enhancements: PolymorphicValueConverter for handling polymorphic types, and ToRemoveJsonComments for cleaning JSON strings.
• XML Utilities: Simplified methods for XML parsing and transformation.

4. IO & Diagnostics (System.IO, System.Diagnostics)

• File System: Recursive directory deletion, safe file reading, and path normalization.
• Diagnostics: Simplified output methods like ToTrace() and ToDebug() for direct logging to debug terminals.
• Console Interaction: Built-in ProgressBar for displaying task progress in the command line.

Usage Examples

String Manipulation

using System;

// Truncate with an ellipsis
string title = "This is a very long article title that needs to be shortened";
string display = title.TruncateWithPostfix(20, "..."); // "This is a very lon..."

// Case conversion
string kebab = "UserRoleMember".ToKebabCase(); // "user-role-member"

Robust Parameter Checking

public void UpdateEmail(string email)
{
    // Throws an exception with the parameter name if email is null or whitespace
    Check.NotNullOrWhiteSpace(email, nameof(email));
    
    // Logic here...
}

Console Progress Bar

using (var progress = new ProgressBar()) 
{
    for (int i = 0; i <= 100; i++) 
    {
        progress.Report((double)i / 100);
        // Execute task...
    }
}

Links

• Support
• NuGet Packages
• License