UtilBlast 2.0.0

UtilBlast ⚡

UtilBlast is a lightweight utility + abstractions library for .NET.
It bundles extensions, interfaces, and a Factory for quick bootstrapping with dependency injection (DI) — designed to work in apps, LINQPad, and PowerShell.

✨ Features

• Extensions

  • DateTime helpers (start/end of day, working days, unix time, etc.)
  • String helpers (PascalCase, CamelCase, SnakeCase, etc.)
  • Math helpers (Add, Multiply, Clamp, Factorial, etc.)
  • DataTable formatting (Dump(), RFC 4180 ToCsv() / ParseCsvToDataTable(), filtering, sorting, distinct rows)
  • IEnumerable<T>.ToCsv() — reflect properties, write CSV in one line (new in 1.1)
  • Json ⇆ Csv bridge (JsonToCsv(), CsvToJson()) — auto-flattens nested objects + arrays (new in 1.1)
  • JObject.Flatten() and JToken.GetByPath("a.b[0].c") for nested-JSON ergonomics (new in 1.1)
  • Json (pretty-print, serialize/deserialize with Newtonsoft)
  • Markdown (parse YAML metadata frontmatter)
  • Guid ⇆ byte[] conversions
  • ExpandoObject.Dump() for debugging

• Interfaces

  • IFileHelper – file and directory utilities (read, write, zip, cleanup)
  • ILocalStorage – in-memory key/value store with TTL, regex queries, persistence
  • ISqlGenerator – simple SQL (SELECT/INSERT/UPDATE/DELETE) + parameter mapping
  • IBlastLogger – logging abstraction (default adapter wraps ILogger<T>)

  Note: UtilBlast 2.0 no longer ships IDynamicClassBuilder / IDynamicClassGenerator. For runtime class generation use the AssemblyBlast sibling package directly.

• Factory 🔥

  • UtilBlastFactory.Create() → get a ready-to-use DI container
  • UtilBlastFactory.Get<T>() → one-liner to resolve a service
  • Built-in console logging option, or plug in your own IBlastLogger

🚀 Install

dotnet add package UtilBlast

🖥 Usage

In a .NET app

using Microsoft.Extensions.DependencyInjection;
using UtilBlast;
using UtilBlast.Interfaces;

var services = new ServiceCollection()
    .AddLogging(b => b.AddConsole())
    .AddUtilBlast();

var provider = services.BuildServiceProvider();
var files = provider.GetRequiredService<IFileHelper>();

files.WriteFile("test.txt", "Hello, UtilBlast!");

In LINQPad

// Press F4 -> Add NuGet -> UtilBlast + Microsoft.Extensions.Logging.Console

var log = UtilBlast.UtilBlastFactory.Get<UtilBlast.Interfaces.IBlastLogger>();
log.Information("Hello from UtilBlast in LINQPad!");

var store = UtilBlast.UtilBlastFactory.Get<UtilBlast.Interfaces.ILocalStorage>();
store.SetData("user", "Alice");
store.ListAllData().Dump();

In PowerShell 7+

# Load assemblies (from NuGet install folder)
Add-Type -Path ".\lib\UtilBlast.dll"
Add-Type -Path ".\lib\Microsoft.Extensions.Logging.Console.dll"

# Create provider
$provider = [UtilBlast.UtilBlastFactory]::Create($true)

# Resolve and use services
$file = $provider.GetRequiredService([UtilBlast.Interfaces.IFileHelper])
$file.WriteFile("ps-demo.txt", "Hello from PowerShell")

⚙️ Dependency Injection

Register everything into your own IServiceCollection:

services.AddUtilBlast(opt =>
{
    opt.DefaultLifetime = ServiceLifetime.Singleton;
    // opt.LoggerFactory = sp => new MySerilogLogger(...);
});

📦 Why UtilBlast?

• One NuGet, many helpers
• Works in apps, scripts, and LINQPad with zero boilerplate
• Abstractions for clean testing (IFileHelper, ILocalStorage, …)
• Extensions to cut boilerplate in day-to-day code
• Plug-and-play DI setup with Factory

🤖 AI assistants

This assembly carries the Blast.PrimaryFacade convention: an [AssemblyMetadata("Blast.PrimaryFacade", "...")] attribute names the canonical front-door type(s) of the package, so AI helpers (e.g. TaskBlaster's script assistant) can identify the entry points without scanning every public type.

For UtilBlast the front doors are:

Read it back from a loaded assembly via reflection:

var facade = typeof(UtilBlast.UtilBlastFactory).Assembly
    .GetCustomAttributes<AssemblyMetadataAttribute>()
    .FirstOrDefault(a => a.Key == "Blast.PrimaryFacade")?.Value;

The value is a hint for tooling; consumers don't need to read it.

📄 License

MIT © 2025 — Free to use and modify.