CaseON 1.3.0

CaseON: A Comprehensive C# String Manipulation and Validation Library

CaseON is a lightweight and efficient C# library designed to simplify string manipulation and validation. It provides robust utilities for converting strings to various casing styles, validating common data formats, and, with the addition of the MatchON namespace, enables advanced string similarity comparisons.

Features

String Casing Styles:

Convert strings into the following popular casing formats:

• snake_case
• kebab-case
• PascalCase
• camelCase
• Sentence case
• Title Case

String Validation Methods:

Extensive helper methods to validate common string formats:

• Email Validation: Validates if the string is a valid email address.
• URL Validation: Validates if the string is a properly formatted URL.
• IP Address Validation (IPv4 & IPv6): Validates if the string matches the format for valid IPv4 and IPv6 addresses.
• Alphanumeric, Numeric, Alphabetic Validation: Verifies if the string contains only alphanumeric, numeric, or alphabetic characters.
• Phone Number Validation: Ensures the string matches the format of a valid phone number.
• GUID, File Path, and Hex Color Validation: Validates GUIDs, file paths, and hex color codes.
• Base64 String Validation: Validates if the string is a valid Base64 encoded string.
• Credit Card, Routing Number, and CVV Validation: Validates credit card numbers, bank routing numbers, and CVVs using standard algorithms.
• IBAN, ISBN, and Social Security Number (SSN) Validation: Validates international banking account numbers, ISBNs, and US SSNs.
• Date, Postal Code, and Address Validation: Verifies if the string is a valid date, postal code (supports multiple countries), or physical address.
• JSON and XML Validation: Validates if the string is in proper JSON or XML format.

Advanced String Similarity Matching:

With the new MatchON namespace, CaseON adds several advanced string similarity algorithms:

• Levenshtein Distance: Measures the minimum number of single-character edits required to transform one string into another.
• Jaro-Winkler Similarity: Computes the similarity between two strings, focusing on the number of common characters and their order.
• Longest Common Subsequence (LCS): Measures similarity based on the longest subsequence present in both strings.

Robust Input Handling:

• Throws informative ArgumentExceptions for null or empty/whitespace input strings.
• Handles strings containing spaces, underscores, hyphens, and various separators.
• Ensures that common data formats are properly validated before usage.

Easy to Use:

• Simple static methods provide a clean and intuitive API.
• Built-in validation methods for common use cases make it easy to ensure input correctness.

Lightweight:

• Minimal dependencies, easy to integrate into existing projects.
• The library can be used for both string casing conversions and data format validation.

Version 1.3.0 Changelog

New Features:

• New MatchON Namespace:

  • Introduced a new namespace MatchON that includes advanced string similarity matching algorithms to compare strings with greater accuracy. The following methods are now available:
    • Levenshtein Distance: Measures the number of edits required to transform one string into another, with a normalized similarity score returned between 0 and 1.
    • Jaro-Winkler Similarity: Computes the similarity based on the number of common characters and their relative order, returning a score adjusted for prefixes.
    • Longest Common Subsequence (LCS): Computes the longest subsequence common to both strings and provides a similarity score based on the LCS length.

• String Validation Methods:

  • Enhanced the string validation capabilities with 15+ new validation methods for various formats including email, URL, IP addresses, phone numbers, and more.

Bug Fixes & Improvements:

• Fixed minor bugs related to input handling for edge cases in validation methods.
• Improved the performance of string casing conversion methods for longer strings.

Usage

1. Installation: You can easily add CaseON to your project via NuGet. Alternatively, you can directly include the source code in your project.

2. Basic Example:

using CaseON;

// String Casing
string myString = "This Is A Test String";

string snakeCase = CaseON.ConvertON.ToSnakeCase(myString);      // Output: this_is_a_test_string
string kebabCase = CaseON.ConvertON.ToKebabCase(myString);     // Output: this-is-a-test-string
string pascalCase = CaseON.ConvertON.ToPascalCase(myString);    // Output: ThisIsATestString
string camelCase = CaseON.ConvertON.ToCamelCase(myString);     // Output: thisIsATestString
string sentenceCase = CaseON.ConvertON.ToSentenceCase(myString); // Output: This is a test string
string titleCase = CaseON.ConvertON.ToTitleCase(myString);     // Output: This Is A Test String

Console.WriteLine($"Snake Case: {snakeCase}");
Console.WriteLine($"Kebab Case: {kebabCase}");
Console.WriteLine($"Pascal Case: {pascalCase}");
Console.WriteLine($"Camel Case: {camelCase}");
Console.WriteLine($"Sentence Case: {sentenceCase}");
Console.WriteLine($"Title Case: {titleCase}");

string email = "test@example.com";
string url = "https://www.example.com";
string ipAddress = "192.168.1.1";
string phoneNumber = "+1234567890";
string postalCode = "90210";
string date = "2024-11-26";

bool isValidEmail = CaseON.ValidateON.IsValidEmail(email);                // Output: true
bool isValidUrl = CaseON.ValidateON.IsValidUrl(url);                      // Output: true
bool isValidIp = CaseON.ValidateON.IsValidIPv4(ipAddress);                // Output: true
bool isValidPhone = CaseON.ValidateON.IsValidPhoneNumber(phoneNumber);    // Output: true
bool isValidPostal = CaseON.ValidateON.IsValidPostalCode(postalCode);     // Output: true
bool isValidDate = CaseON.ValidateON.IsValidDate(date);                   // Output: true

Console.WriteLine($"Valid Email: {isValidEmail}");
Console.WriteLine($"Valid URL: {isValidUrl}");
Console.WriteLine($"Valid IP Address: {isValidIp}");
Console.WriteLine($"Valid Phone Number: {isValidPhone}");
Console.WriteLine($"Valid Postal Code: {isValidPostal}");
Console.WriteLine($"Valid Date: {isValidDate}");


// String Similarity Matching with MatchON
string string1 = "hello world";
string string2 = "hello wrld";

double levenshteinSimilarity = MatchON.GetSimilarity(string1, string2);  // Similarity based on Levenshtein Distance
double jaroWinklerSimilarity = MatchON.GetJaroWinklerSimilarity(string1, string2); // Similarity based on Jaro-Winkler
double lcsSimilarity = MatchON.GetLcsSimilarity(string1, string2);  // Similarity based on Longest Common Subsequence

Console.WriteLine($"Levenshtein Similarity: {levenshteinSimilarity}");  // Output: Similarity score between 0 and 1
Console.WriteLine($"Jaro-Winkler Similarity: {jaroWinklerSimilarity}");  // Output: Similarity score between 0 and 1
Console.WriteLine($"LCS Similarity: {lcsSimilarity}");  // Output: Similarity score between 0 and 1