Humanizr/Humanizer
Humanizer
Humanizer is a .NET natural language formatter and string manipulation library designed to convert technical identifiers, numbers, and dates into grammatically correct, human-readable text. It functions as a pluralization engine, localization utility, and case conversion tool for the .NET ecosystem.
The library provides specialized capabilities for transforming programming conventions like PascalCase or snake_case into readable sentences and vice versa. It distinguishes itself by handling irregular and uncountable English words during pluralization and singularization, and by applying culture-specific rules to ordinals and grammatical gender.
The project covers a broad range of data representation utilities, including the conversion of byte sizes, metric numerals, and Roman numerals. It also manages natural language formatting for time spans, relative date descriptions, and the transformation of numeric values into full word representations.
Features
- Case Conversion Utilities - Transforms strings between different coding formats like PascalCase and snake_case.
- Natural Language Manipulators - Provides a specialized toolkit for transforming the grammatical form of technical identifiers and numeric values into human-readable text.
- Natural Language Formatters - Transforms numbers, dates, and time durations into human-readable words and relative descriptions.
- Singularization Rules - Transforms plural nouns into their singular forms while accounting for irregular English words.
- Duration Formatters - Converts time durations into human-friendly strings with configurable precision.
- Internationalization and Localization - Implements culture-specific rules for ordinals, grammatical gender, and date formatting.
- Noun Number Transformers - Combines numbers with correctly pluralized nouns to format quantities in natural language.
- Numeric and Date Formatting - Translates date values into ordinal word formats that match regional cultural norms.
- Date and Time Utilities - Provides .NET extensions to transform timestamps and durations into relative descriptions.
- Relative Date Formatting - Generates relative time descriptions such as yesterday or 2 hours ago.
- Static Dictionary Lookups - Stores irregular pluralization and singularization rules in fixed datasets to handle linguistic exceptions.
- String Manipulation Utilities - Offers general purpose functions for altering string casing and transforming technical identifiers into natural language sentences.
- Pluralization Rules - Transforms singular nouns into plural forms while handling irregular and uncountable English words.
- Number-to-Word Converters - Transforms numeric values into full word representations while accounting for grammatical gender and culture.
- String Manipulators - Provides utilities for formatting and transforming technical strings into readable text and vice versa.
- Culture-Specific Data Mapping - Implements culture-aware data mapping to ensure grammatically correct translations across different languages.
- Localization Utilities - Offers a set of .NET tools for formatting ordinals, dates, and numbers according to cultural rules.
- Collection Formatters - Formats lists of objects into naturally punctuated strings using custom separators.
- Text Processing Utilities - Manages pluralization, singularization, and smart truncation for natural sounding lists and labels.
- Data Size Converters - Transforms raw byte counts into readable storage strings and parses them back.
- Enum Label Mappings - Uses reflection to map enumeration members to their custom human-readable description attributes.
- Fluent Date Processing - Provides a fluent syntax for manipulating dates and times using natural language extensions.
- Data Representation Utilities - Converts byte sizes and metric numerals into readable shorthand and parses them back.
- Clock Notation Converters - Transforms time values into readable clock descriptions such as half past two or noon.
- Extension Methods - Provides a fluent API by leveraging .NET extension methods to add functionality to existing types.
- Fluent Interfaces - Employs a fluent interface design allowing multiple transformation operations to be chained in a single statement.
- Metric Numeral Formatting - Changes numbers into abbreviated metric notation like 1.23k and parses them back into numeric values.
- Identifier Generators - Converts human-friendly sentences back into PascalCase programming identifiers for use in code.
- Symmetry-Based Parsing - Provides inverse logic to convert human-readable strings back into their original technical identifiers.
- Roman Numeral Converters - Translates integers into Roman numeral strings and converts them back into integers.
- Metadata Parsing - Inspects assembly attributes on enumeration members to extract custom human-readable descriptions.
- Rule-Based Pattern Matching - Employs conditional string patterns to identify and transform coding conventions and numeric formats.
- Rule-Based String Parsing - Uses a series of conditional pattern matches to identify and transform specific coding conventions.
- Ordinal Formatters - Converts integers into ordinal strings while supporting culture-specific grammatical gender.
- Word-to-Number Parsers - Parses English word representations of numbers back into standard numeric data types.
- Content Format Transformers - Applies built-in or custom transformations to change string casing and formatting.
- General Utilities - Manipulation and formatting of strings, dates, and numbers.
