Dotnet Util

Utilities for common development tasks in .NET: flow control (conditions, retries and waiters), hashing (Argon2id), file I/O helpers, random values and strings, regex helpers, and small collections.

Installation

• NuGet (recommended): publish or consume the package when available.
  • Package ID (assumed): ArturRios.Util.
  • Add to your project:
    • dotnet CLI: dotnet add package ArturRios.Util
    • Or reference locally:
      • Add a project reference to src/ArturRios.Util.csproj in your .csproj:

        <ItemGroup>
          <ProjectReference Include="..\src\ArturRios.Util.csproj" />
        </ItemGroup>

Quickstart

• Collections
  • ANSI colors: Console.WriteLine($"{ArturRios.Util.Collections.AnsiColors.Green}Success\x1b[0m");
  • Character pools: Characters.Digits + Characters.UpperLetters
• FlowControl
  • Condition:

    using ArturRios.Util.FlowControl;
    Condition.Create
      .True(user is not null).FailsWith("User is required")
      .True(emailValid).FailsWith("Invalid email")
      .ThrowIfNotSatisfied();

  • Retry:

    using ArturRios.Util.FlowControl;
    Retry.New.MaxAttempts(3).DelayMilliseconds(200).Execute(() => DoFragileWork());
    var result = Retry.New.MaxAttempts(5).Execute(() => Compute());

  • Jittered waiter:

    using ArturRios.Util.FlowControl.Waiter;
    var waiter = new JitteredWaiter(maxRetryCount: 5);
    while (waiter.CanRetry)
    {
        try { await TryOperationAsync(); break; }
        catch { await waiter.Wait(); }
    }

• Hashing (Argon2id)

  using ArturRios.Util.Hashing;
  var hash = Hash.EncodeWithRandomSalt("secret", out var salt);
  var ok = Hash.TextMatches("secret", hash, salt);

• IO

  using ArturRios.Util.IO;
  var text = FileReader.Read(path);
  var lines = FileReader.ReadLines(path);
  var dict = FileReader.ReadAsDictionary(path, ',');
  var obj = FileReader.ReadAndDeserialize<MyType>(jsonPath);
  // Async variants available on FileReaderAsync

• Random

  using ArturRios.Util.Random;
  var n1 = CustomRandom.NumberFromRng(1, 10);
  var n2 = CustomRandom.NumberFromSystemRandom(0, 100, differentFrom: 42);
  var pwd = CustomRandom.Text(new RandomStringOptions { Length = 16, IncludeSpecialCharacters = true });

• RegularExpressions

  using ArturRios.Util.RegularExpressions;
  var isEmail = RegexCollection.Email().IsMatch("john@doe.com");
  var stripped = RegexCollection.HasNumber().Remove("abc123def"); // -> "abcdef"

---

Folder to Features Map

• src/Collections: ANSI color codes and character sets.
• src/FlowControl: condition evaluation, simple retry, jittered waiter.
• src/Hashing: Argon2id hashing helpers and configuration.
• src/IO: file reading (text, lines, CSV-like to dictionary) and JSON deserialization, sync and async.
• src/Random: random integers and constrained random string generation.
• src/RegularExpressions: common regex patterns and extensions.

---

Collections

Features:

• AnsiColors: constants for console foreground colors via ANSI escape codes.
• Characters: constants for digits, lower/upper letters, special characters, and union All.

Mermaid class diagram:

classDiagram
    namespace Collections {
        class AnsiColors {
            <<static>>
            +string DarkGray
            +string Cyan
            +string White
            +string Yellow
            +string Red
            +string Magenta
            +string BrightRed
            +string Green
        }
        class Characters {
            <<static>>
            +string Digits
            +string LowerLetters
            +string UpperLetters
            +string Special
            +string All
        }
    }

Loading

---

FlowControl

Features:

• Condition: fluent condition aggregator with failure messages; can throw or convert to process output.
• Retry: simple retry utility with max attempts and fixed delay; supports Action and Func<T>.
• Waiter/JitteredWaiter: exponential backoff with jitter; guards with CanRetry and throws MaxRetriesReachedException when exceeded.
• Waiter/MaxRetriesReachedException: custom exception for retry exhaustion.

Mermaid class diagram:

classDiagram
    namespace FlowControl {
        class Condition {
            -HashSet<string> _failedConditions
            -bool _expression
            +static Condition Create
            +string[] FailedConditions
            +bool IsSatisfied
            +Condition True(bool expression)
            +Condition False(bool expression)
            +Condition FailsWith(string error)
            +void ThrowIfNotSatisfied()
            +ProcessOutput ToProcessOutput()
        }
        class ConditionFailedException {
            +string[] Errors
        }

        class Retry {
            -int _delayMilliseconds
            -int _maxAttempts
            +static Retry New
            +Retry MaxAttempts(int maxAttempts)
            +Retry DelayMilliseconds(int delayMilliseconds)
            +void Execute(Action action)
            +T Execute~T~(Func~T~ func)
        }
    }

    namespace FlowControl_Waiter {
        class JitteredWaiter {
            -const int FixedWaitDelay
            +int MaxRetryCount
            -int Count
            +bool CanRetry
            +Task Wait()
        }
        class MaxRetriesReachedException
    }

Loading

---

Hashing

Features:

• Hash: Argon2id helpers to encode with provided or random salt, and verify matches.
• HashConfiguration: configurable cost parameters: degree of parallelism, iterations, memory in KB.

Mermaid class diagram:

classDiagram
    namespace Hashing {
        class Hash {
            <<static>>
            -const int Argon2IdKeyBytes
            -const int SaltByteSize
            -byte[] CreateSalt()
            +byte[] EncodeWithSalt(string text, byte[] salt, HashConfiguration? configuration)
            +byte[] EncodeWithRandomSalt(string text, out byte[] salt, HashConfiguration? configuration)
            +bool TextMatches(string text, byte[] hash, byte[] salt)
        }
        class HashConfiguration {
            +const int DefaultDegreeOfParallelism
            +const int DefaultNumberOfIterations
            +const int DefaultMemoryToUseInKb
            +int DegreeOfParallelism
            +int NumberOfIterations
            +int MemoryToUseInKb
        }
    }

Loading

---

IO

Features:

• FileReader (sync): read text, lines, CSV-like to dictionary, JSON to object.
• FileReaderAsync (async): same operations asynchronously.

Mermaid class diagram:

classDiagram
    namespace IO {
        class FileReader {
            <<static>>
            +string Read(string path)
            +string[] ReadLines(string path)
            +Dictionary~string, string[]~ ReadAsDictionary(string path, char separator)
            +T ReadAndDeserialize~T~(string path)
        }
        class FileReaderAsync {
            <<static>>
            +Task~string~ ReadAsync(string path)
            +Task~string[]~ ReadLinesAsync(string path)
            +Task~Dictionary~string, string[]~~ ReadAsDictionaryAsync(string path, char separator)
            +Task~T~ ReadAndDeserializeAsync~T~(string path)
        }
    }

Loading

---

Random

Features:

• CustomRandom: random integers via RNG or System.Random, and constrained random strings.
• RandomStringOptions: options for length and inclusion of lowercase, uppercase, digits, and special characters.

Mermaid class diagram:

classDiagram
    namespace Random {
        class RandomStringOptions {
            +int Length
            +bool IncludeLowercase
            +bool IncludeUppercase
            +bool IncludeDigits
            +bool IncludeSpecialCharacters
        }
        class CustomRandom {
            <<static>>
            +int NumberFromRng(int start, int end, int? differentFrom)
            +int NumberFromSystemRandom(int start, int end, int? differentFrom)
            +string Text(RandomStringOptions options, string[]? differentFrom)
        }
    }

Loading

---

RegularExpressions

Features:

• RegexCollection: common patterns with source-generated compiled regex methods.
  • Email, has number, has lower, has upper, has number+lower+upper.
• RegexExtensions: convenience extension to remove all matches via Regex.Remove.

Mermaid class diagram:

classDiagram
    namespace RegularExpressions {
        class RegexCollection {
            <<static>>
            +const string EmailPattern
            +const string HasNumberPattern
            +const string HasLowerCharPattern
            +const string HasUpperCharPattern
            +const string HasNumberLowerAndUpperCharPattern
            +Regex Email()
            +Regex HasNumber()
            +Regex HasLowerChar()
            +Regex HasUpperChar()
            +Regex HasNumberLowerAndUpperChar()
        }
        class RegexExtensions {
            <<static>>
            +string Remove(Regex regex, string @string)
        }
    }

Loading

---

Contributing

• Tests live under tests/ArturRios.Util.Tests. Please add tests for new features and run them before submitting PRs.
• Follow typical .NET coding conventions and keep public APIs documented with XML comments.

Legal Details

This project is licensed under the MIT License. A copy of the license is available at LICENSE in the repository.

---