CaseON 3.0.0

CaseON

The all-in-one .NET string toolkit. Fast, dependency-free, AOT- and trim-friendly, and organized into small, discoverable modules you can call in one line.

using CaseON;

Text.ToSnakeCase("HelloWorld");      // "hello_world"
Validate.Email("user@example.com");  // true
Country.GetCallingCode(CountryCode.India); // 91
Slug.Generate("Héllo, World!");      // "hello-world"
Hash.Sha256("abc");                  // "ba7816bf8f01..."

Add one using CaseON; and every module is available as Module.Method(...) — no setup, no DI, no configuration.

Install

dotnet add package CaseON

Targets net8.0 and net9.0. Zero runtime dependencies.

Modules at a glance

Quick start

using CaseON;

// Casing
Text.ToKebabCase("MyVariableName");          // "my-variable-name"
Text.ToSnakeCase("HTTPServer", preserveAcronyms: true); // "http_server"
Text.Humanize("first_name");                 // "First Name"
Text.Truncate("The quick brown fox", 12);    // "The quick b…"

// Validation
Validate.Iban("GB82 WEST 1234 5698 7654 32"); // true
Validate.PostalCode("M5V 3L9", CountryCode.Canada); // true

// Similarity & fuzzy search
Similarity.JaroWinkler("MARTHA", "MARHTA");  // ~0.961
Fuzzy.BestMatch("aple", new[] { "apple", "grape" })!.Value.Value; // "apple"

// Encoding & hashing
Encode.Base58("hello");                       // "Cn8eVZg"
Hash.XxHash64("abc");                          // non-cryptographic 64-bit hash

// Inflection & slugs
Inflect.Pluralize("category");                // "categories"
Inflect.Ordinalize(21);                       // "21st"
Slug.Generate("Crème Brûlée");                // "creme-brulee"

Design notes

• Dependency-free & AOT-friendly. The library has no runtime package dependencies and is marked IsAotCompatible/IsTrimmable. Linguistic features (transliteration, language detection, profanity) are implemented in-box rather than via reflection/data-file packages, so they work under trimming and Native AOT.
• Safe by default. Validate.* and Extract.* return false/empty for null input instead of throwing. All regular expressions are source-generated, culture-invariant and guarded with a match timeout to prevent ReDoS.
• Performance. Dynamic-programming algorithms use rolling rows and ArrayPool<T>; hot paths such as Similarity.LevenshteinDistance offer ReadOnlySpan<char> overloads.
• Security note. Hash.Md5/Hash.Sha1 are provided for checksums and interoperability only — use Sha256/Sha512 for security. Validators perform structural checks, not authoritative verification. Generate.Token/Generate.Password use a cryptographically secure RNG.

Versioning

CaseON follows Semantic Versioning. See CHANGELOG.md.

Contributing

Contributions are welcome — see CONTRIBUTING.md. Security issues: see SECURITY.md.

License

Licensed under the MIT License.