Indiko.Common.Utils 2.1.2

Indiko.Common.Utils

Comprehensive utility library providing extensions, helpers, and diagnostic tools for .NET applications.

Overview

This package contains a rich set of extension methods, helper classes, and diagnostic utilities that enhance productivity and simplify common programming tasks in .NET applications.

Features

• String Extensions: Comprehensive string manipulation (slugify, truncate, case conversion, Base64, etc.)
• DateTime Extensions: Advanced date/time operations and formatting
• Collection Extensions: LINQ enhancements for IEnumerable, IList, and IAsyncEnumerable
• Expression Extensions: Expression tree manipulation utilities
• Reflection Extensions: Simplified reflection operations
• Enum Extensions: Enhanced enum handling and conversion
• TimeSpan Extensions: Duration formatting and manipulation
• Async Helpers: Utilities for async/await patterns
• Diagnostics: Performance monitoring (GC, memory, thread diagnostics, invocation time tracking)
• ICal Support: iCalendar recurrence rule parsing and calculation
• MIME Type Mapping: File extension to MIME type conversions

Installation

dotnet add package Indiko.Common.Utils

Usage Examples

String Extensions

using Indiko.Common.Utils.Extensions;

// Case conversion
string camelCase = "hello world".ToCamelCase(); // "helloWorld"
string pascalCase = "hello world".ToPascalCase(); // "HelloWorld"

// Slugify for URLs
string slug = "Hello World! 2024".Slugify(); // "hello-world-2024"

// Truncate with ellipsis
string truncated = "Very long text".Truncate(10); // "Very long..."

// Base64 encoding/decoding
string encoded = "secret".ToBase64();
string decoded = encoded.FromBase64();

// Check nullability
bool isEmpty = text.IsNullOrEmptyOrWhiteSpace();

// MIME type operations
string mimeType = ".pdf".MimeTypeFromFileExtension(); // "application/pdf"
string extension = "image/jpeg".FileExtensionFromMimeType(); // ".jpg"

DateTime Extensions

using Indiko.Common.Utils.Extensions;

var date = DateTime.Now;
// Various date operations available

Collection Extensions

using Indiko.Common.Utils.Extensions;

var list = new List<int> { 1, 2, 3, 4, 5 };
// Enhanced LINQ operations

var asyncItems = await asyncEnumerable.ToListAsync();

Diagnostics

using Indiko.Common.Utils.Diagnostics;

// Track memory usage
var memoryTracker = new MemoryUsageTracker();
memoryTracker.Start();
// ... perform operations
memoryTracker.Stop();
Console.WriteLine($"Memory used: {memoryTracker.MemoryUsed} bytes");

// Monitor garbage collection
var gcMonitor = new GCMonitor();
gcMonitor.Start();

// Measure invocation time
var timer = new InvocationTime();
timer.Start();
// ... perform operations
var elapsed = timer.Stop();

// Thread diagnostics
ThreadDiagnostics.DumpThreadInfo();

ICal Recurrence Rules

using Indiko.Common.Utils.Helper.ICal;

var rule = new RecurrenceRule
{
    Frequency = "DAILY",
    Interval = 1,
    Count = 10
};

var calculator = new RecurrenceCalculator();
var dates = calculator.Calculate(rule, DateTime.Now);

Object Extensions

using Indiko.Common.Utils.Extensions;

var obj = new MyClass();
// Object manipulation extensions

Target Framework

• .NET 10

Dependencies

This package has minimal dependencies and primarily extends the .NET BCL.

License

See LICENSE file in the repository root.

Related Packages

• Indiko.Common.Abstractions - Core abstractions and base types
• Indiko.Common.Runtime.Abstractions - Runtime and bootstrapping abstractions