NextGenSoftware.Utilities 2.0.3

NextGenSoftware.Utilities

A broad shared utility library — string helpers, data conversion, encryption, key generation, validation, path resolution, directory tools, list helpers, and more. Used across every OASIS Omniverse project.

Part of the OASIS Omniverse v2.0 Reboot. Visit oasisomniverse.one.

Installation

dotnet add package NextGenSoftware.Utilities

String Extension Methods

using NextGenSoftware.Utilities.ExtentionMethods;

"myVariableName".ToSnakeCase()   // "my_variable_name"
"my_variable".ToCamelCase()      // "myVariable"
"my_variable_name".ToPascalCase() // "MyVariableName"

StringHelper

bool ok = StringHelper.IsValidVersion("1.2.3");   // true
bool bad = StringHelper.IsValidVersion("1.2.3.4.5"); // false (max 4 parts)

DataHelper

string csv  = DataHelper.ConvertBinaryDataToString(bytes);          // "72,101,108,108,111"
string text = DataHelper.DecodeBinaryDataAsUTF8(bytes);             // "Hello"
string csv2 = DataHelper.ConvertBinaryDataToString(bytes, false);   // include zero bytes

FileEncryption (AES + RSA)

// AES file encryption
byte[] key = ...; byte[] iv = ...;
FileEncryption.EncryptFile("input.dat", "encrypted.dat", key, iv);
FileEncryption.DecryptFile("encrypted.dat", "output.dat", key, iv);
string text = FileEncryption.DecryptFile("encrypted.dat", key, iv); // returns string

// RSA string encryption (Windows CryptoServiceProvider)
string cipher = myString.Encrypt("MyKeyContainerName");
string plain  = cipher.Decrypt("MyKeyContainerName");

KeyHelper — Blockchain Key Generation

var keypair = KeyHelper.GenerateKeyValuePairAndWalletAddress();
Console.WriteLine(keypair.PublicKey);            // hex-encoded secp256k1 public key
Console.WriteLine(keypair.PrivateKey);           // hex-encoded private key
Console.WriteLine(keypair.WalletAddressLegacy);  // P2PKH Bitcoin address (hex scriptPubKey)
Console.WriteLine(keypair.WalletAddressSegwitP2SH); // P2SH-SegWit address (hex scriptPubKey)

bool validPub  = KeyHelper.IsValidRsaPublicKey(pemString);
bool validPriv = KeyHelper.IsValidRsaPrivateKey(pemOrDerString);

IKeyPairAndWallet

public interface IKeyPairAndWallet {
    string PublicKey { get; set; }
    string PrivateKey { get; set; }
    string WalletAddressLegacy { get; set; }
    string WalletAddressSegwitP2SH { get; set; }
}

WalletAddressHelper

string address = WalletAddressHelper.PrivateKeyToAddress(wifPrivateKey);
string address2 = WalletAddressHelper.PublicKeyToAddress(pubKeyHex);

ValidationHelper

bool valid = ValidationHelper.IsValidEmail("user@example.com"); // true
bool bad   = ValidationHelper.IsValidEmail("not-an-email");     // false

URIHelper

bool exists = await URIHelper.ValidateUrlWithHttpClientAsync("https://oasisomniverse.one");

ListHelper

List<string> list = ListHelper.ConvertToList("apple,banana,cherry");
string csv = ListHelper.ConvertFromList(list); // "apple,banana,cherry"

EnumHelper

string newline = EnumHelper.GetEnumValues(typeof(ConsoleColor));
// "Black\nDarkBlue\nDarkGreen\n..."

string comma = EnumHelper.GetEnumValues(typeof(ConsoleColor), EnumHelperListType.ItemsSeperatedByComma);
// "Black, DarkBlue, DarkGreen, ... or White"

IEnumerable<EnumValue<ConsoleColor>> wrapped = EnumHelper.ConvertToEnumValueList(colours);
IEnumerable<ConsoleColor> unwrapped = EnumHelper.ConvertFromEnumValueList(wrapped);

ExpandoObjectHelpers

using NextGenSoftware.Utilities.ExtentionMethods;

dynamic obj = new ExpandoObject();
ExpandoObjectHelpers.AddProperty(obj, "Name", "OurWorld");
ExpandoObjectHelpers.AddProperty(obj, "Name", "Updated"); // updates existing key
Console.WriteLine(obj.Name); // "Updated"

DirectoryHelper

DirectoryHelper.CopyFilesRecursively("C:/source", "C:/dest");

AppPathHelper

Reliable cross-platform app root and user data path resolution.

string appRoot  = AppPathHelper.ResolveAppRootDirectory();
string fullPath = AppPathHelper.ResolvePathFromAppRoot("config/settings.json");
string basePath = AppPathHelper.ResolveBasePath(appRoot, configured);
bool writable   = AppPathHelper.IsDirectoryWritable(appRoot);
string userData = AppPathHelper.GetUserDataRoot("my-app");
string subDir   = AppPathHelper.GetUserDataSubDirectory("my-app", "logs");

PathHelper

string normalized = PathHelper.NormalizePathFromConfig("some/forward/slash/path");
// On Windows: "some\forward\slash\path"
// On Linux/macOS: "some/forward/slash/path"

• oasisomniverse.one | GitHub

MIT — Copyright © NextGen Software Ltd 2019 - 2026