Simple.CaseConverter 1.0.6

Simple.CaseConverter

🚀 Overview

Simple.CaseConverter is a lightweight and efficient .NET library for converting strings between common casing styles such as camelCase, PascalCase, snake_case, kebab-case, and more.
It focuses on speed, correctness, and simplicity with zero dependencies beyond .NET.

🔑 Key Features

• 🔄 Supports multiple case conversions: camelCase, PascalCase, snake_case, kebab-case, and more
• ⚡ Extremely fast performance with optimized algorithms
• 🧩 Simple and intuitive API for easy integration
• 🧪 Supports culture-invariant conversions and ASCII/non-ASCII characters
• 📚 Well-tested with comprehensive unit tests
• 🏆 Benchmark results showing performance advantages over similar libraries
• 🧩 Compatible with .NET 8 and later

📚 Table of Contents

1. Getting Started
   • Installing
   • Usage
2. Casings Supported
3. Examples
4. Benchmark Results
5. Technical Information
6. Known Issues & Limitations
7. Contributing
8. License

🚦 Getting Started

Convert strings easily between different case styles with Simple.CaseConverter.

📦 Installing

Add the package via NuGet:

dotnet add package Simple.CaseConverter

🧪 Usage

var camel = "hello_world".ToCamelCase();
Console.WriteLine(camel);  // Output: helloWorld

🎯 Casings Supported

• camelCase
• PascalCase
• snake_case
• kebab-case
• SCREAMING_SNAKE_CASE
• SCREAMING-KEBAB-CASE
• Train-Case
• Title Case
• Sentence case
• lowercase
• UPPERCASE

🔍 Examples

const string example1 = "John Doe, the first";

Console.WriteLine("Example 1: \"" + example1 + "\"");
Console.WriteLine("  Camel case: " + example1 + " -> " + example1.ToCamelCase());
Console.WriteLine("  Kebab case: " + example1 + " -> " + example1.ToKebabCase());
Console.WriteLine("  Lower case: " + example1 + " -> " + example1.ToLowerCase());
Console.WriteLine("  Pascal case: " + example1 + " -> " + example1.ToPascalCase());
Console.WriteLine("  Screaming kebab case: " + example1 + " -> " + example1.ToScreamingKebabCase());
Console.WriteLine("  Screaming snake case: " + example1 + " -> " + example1.ToScreamingSnakeCase());
Console.WriteLine("  Sentence case: " + example1 + " -> " + example1.ToSentenceCase());
Console.WriteLine("  Snake case: " + example1 + " -> " + example1.ToSnakeCase());
Console.WriteLine("  Title case: " + example1 + " -> " + example1.ToTitleCase());
Console.WriteLine("  Train case: " + example1 + " -> " + example1.ToTrainCase());
Console.WriteLine("  Upper case: " + example1 + " -> " + example1.ToUpperCase());
Console.WriteLine();

const string example2 = "JaneDoe - the second";

Console.WriteLine("Example 2: \"" + example2 + "\"");
Console.WriteLine("  Camel case: " + example2 + " -> " + example2.ToCamelCase());
Console.WriteLine("  Kebab case: " + example2 + " -> " + example2.ToKebabCase());
Console.WriteLine("  Lower case: " + example2 + " -> " + example2.ToLowerCase());
Console.WriteLine("  Pascal case: " + example2 + " -> " + example2.ToPascalCase());
Console.WriteLine("  Screaming kebab case: " + example2 + " -> " + example2.ToScreamingKebabCase());
Console.WriteLine("  Screaming snake case: " + example2 + " -> " + example2.ToScreamingSnakeCase());
Console.WriteLine("  Sentence case: " + example2 + " -> " + example2.ToSentenceCase());
Console.WriteLine("  Snake case: " + example2 + " -> " + example2.ToSnakeCase());
Console.WriteLine("  Title case: " + example2 + " -> " + example2.ToTitleCase());
Console.WriteLine("  Train case: " + example2 + " -> " + example2.ToTrainCase());
Console.WriteLine("  Upper case: " + example2 + " -> " + example2.ToUpperCase());
Console.WriteLine();

Outputs:

Example 1: "John Doe, the first"
  Camel case: John Doe, the first -> johnDoeTheFirst
  Kebab case: John Doe, the first -> john-doe-the-first
  Lower case: John Doe, the first -> johndoethefirst
  Pascal case: John Doe, the first -> JohnDoeTheFirst
  Screaming kebab case: John Doe, the first -> JOHN-DOE-THE-FIRST
  Screaming snake case: John Doe, the first -> JOHN_DOE_THE_FIRST
  Sentence case: John Doe, the first -> John doe the first
  Snake case: John Doe, the first -> john_doe_the_first
  Title case: John Doe, the first -> John Doe The First
  Train case: John Doe, the first -> John-Doe-The-First
  Upper case: John Doe, the first -> JOHNDOETHEFIRST

Example 2: "JaneDoe - the second"
  Camel case: JaneDoe - the second -> janeDoeTheSecond
  Kebab case: JaneDoe - the second -> jane-doe-the-second
  Lower case: JaneDoe - the second -> janedoethesecond
  Pascal case: JaneDoe - the second -> JaneDoeTheSecond
  Screaming kebab case: JaneDoe - the second -> JANE-DOE-THE-SECOND
  Screaming snake case: JaneDoe - the second -> JANE_DOE_THE_SECOND
  Sentence case: JaneDoe - the second -> Jane doe the second
  Snake case: JaneDoe - the second -> jane_doe_the_second
  Title case: JaneDoe - the second -> Jane Doe The Second
  Train case: JaneDoe - the second -> Jane-Doe-The-Second
  Upper case: JaneDoe - the second -> JANEDOETHESECOND

⚡ Benchmark Results

BenchmarkDotNet v0.13.5, Windows 11, .NET 8.0.0

🔬 Technical Information

• Optimized string manipulation algorithms with minimal allocations
• Culture-invariant operations ensuring consistent results
• Supports ASCII and Unicode characters correctly
• Simple API for both specific case methods and general conversion method
• Uses Span<char> and memory-safe code to maximize performance

🐞 Known Issues & Limitations

• Currently supports common casing styles only; custom casing styles are not supported yet
• Some edge cases with unusual Unicode characters may not convert perfectly

🤝 Contributing

Bug reports, feature requests, and pull requests are welcome!
Please open an issue or submit a PR via GitHub Issues.

📄 License

This project is licensed under the MIT License.