Tharga.Toolkit.Standard 1.15.20

Tharga.Toolkit.Standard

.NET Standard 2.0 toolkit with utilities for strings, dates, collections, comparisons, timers, and more.

Installation

dotnet add package Tharga.Toolkit.Standard

Features

String Extensions

// Null/empty helpers
string val = "".NullIfEmpty();         // null
bool empty = "".IsNullOrEmpty();       // true
string safe = ((string)null).IfEmpty("fallback"); // "fallback"

// Random strings (cryptographically secure)
var random = StringExtension.GetRandomString(12, 20);
var pin = 6.RandomString(StringExtension.NumericCharacters); // "482917"

// Base64
var encoded = "hello".ToBase64();      // "aGVsbG8="
var decoded = encoded.FromBase64();    // "hello"

// Truncate
var short = "hello world".Truncate(5); // "hello"

Compare

Deep object comparison that returns a list of differences.

var obj1 = new { Name = "Alice", Age = 30 };
var obj2 = new { Name = "Bob", Age = 30 };

var diffs = obj1.Compare(obj2);
foreach (var diff in diffs)
{
    Console.WriteLine(diff.Message);
}

// Ignore sort order in collections
var diffs2 = list1.Compare(list2, CompareExtensions.CompareMode.IgnoreSortOrder);

DateTime Extensions

// Local formatting
var dateStr = DateTime.UtcNow.ToLocalDateString();       // "2024-01-15"
var timeStr = DateTime.UtcNow.ToLocalTimeString();       // "14:30:00"

// Duration strings (relative time)
var ago = someDate.ToDurationString();                    // "3 hours ago"
var swedish = someDate.ToDurationString(new DurationOptions
{
    StringOptions = DurationStringOptionsExtensions.Get(Language.Sv)
}); // "3 timmar sedan"

// TimeSpan formatting
var span = TimeSpan.FromMinutes(45).ToTimeSpanString();  // "45 minutes"

ManagedTimer

Async timer with interval correction, skip detection, and rich events.

var timer = new ManagedTimer(
    TimeSpan.FromSeconds(5),
    async iteration => { /* your work */ },
    autoStart: true
);

timer.BeforeExecuteEvent += (s, e) => { /* can cancel via e.Cancel = true */ };
timer.AfterExecuteEvent += (s, e) => { /* check e.Exception, e.Elapsed */ };
timer.StateChangedEvent += (s, e) => { /* Started, Executing, Waiting, Stopped */ };

timer.Stop();

Enumerable Extensions

var item = items.TakeRandom();                     // random element
var shuffled = items.RandomOrder();                 // random order
var tail = items.TakeAllButFirst();                 // skip first
var init = items.TakeAllButLast();                  // skip last
var chunks = items.TakeChunks(10);                  // split into groups of 10
bool empty = EnumerableExtensions.IsNullOrEmpty(items);
var safe = EnumerableExtensions.EmptyIfNull(items); // never null

Luhn Check Digits

var check = "7992739871".CheckDigit();       // "3"
var full = "7992739871".AppendCheckDigit();   // "79927398713"
bool valid = "79927398713".HasValidCheckDigit(); // true

// Also works with int, long, and IList<int>
int digit = 36155.CheckDigit(); // 0

Password Hasher

PBKDF2-based password hashing.

var hash = PasswordHasher.HashPassword("myPassword");
bool ok = PasswordHasher.VerifyPassword("myPassword", hash);   // true
bool bad = PasswordHasher.VerifyPassword("wrong", hash);       // false

Collections

// Two-level concurrent dictionary
var dict = new ConcurrentTwoLevelDictionary<string, string, int>();
var (before, after) = dict.AddOrUpdate("users", "alice", 42);

// Observable concurrent dictionary (INotifyCollectionChanged)
var observable = new ObservableConcurrentDictionary<string, int>();
observable.CollectionChanged += (s, e) => { /* react to changes */ };
observable.Add("key", 1);

Semaphore Executor

Key-based async semaphore: same key = sequential, different keys = concurrent.

var executor = new SemaphoreExecutor<string>();
var result = await executor.ExecuteAsync("user-123", async () =>
{
    // Only one operation per key at a time
    return await ProcessAsync();
});

Claims Extensions

Extract identity, email, and display name from ClaimsPrincipal, ClaimsIdentity, or raw claims.

// Identity extraction (checks sub, oid, nameid, uid, NameIdentifier)
var (identity, type) = principal.GetIdentity();

// Email extraction (checks email, emails, preferred_username, name)
var email = principal.GetEmail();
var domain = principal.GetEmailDomain();

// Display name extraction — tries in order:
// 1. "name" (OIDC)  2. ClaimTypes.Name (WS-Fed)  3. "nickname" (Auth0)
// 4. given_name + family_name  5. ClaimTypes.GivenName + Surname
// 6. preferred_username (non-email)  7. email prefix, title-cased
var displayName = principal.GetDisplayName();
// e.g. "daniel.bohlin@example.com" → "Daniel Bohlin"

// Domain-based role assignment
principal.AddRoleForDomain("Developer", "example.com", "contoso.com");

Other Extensions

// Org number parsing (Swedish format)
if ("556123-4567".TryParseOrgNo(out var orgNo))
    Console.WriteLine(orgNo); // "556123-4567"

// Byte size formatting
long bytes = 1536;
Console.WriteLine(bytes.ToReadableByteSize(decimalPlaces: 1)); // "1.5 KB"

// Enum mapping
var target = sourceEnum.MapEnum<TargetEnum, SourceEnum>();

// Exception data helpers
throw new Exception("error")
    .AddData("userId", 123)
    .AddData("action", "save");

// Smart enum
public class Color : Enumeration
{
    public static readonly Color Red = new(1, "Red");
    public static readonly Color Blue = new(2, "Blue");
    private Color(int id, string name) : base(id, name) { }
}
var all = Enumeration.GetAll<Color>();