Number names is a Rust library to provide formatted string names for cardinal and ordinal numbers.
At this time, only American English is supported, but there are future plans for i18n.
See full documentation at https://docs.rs/number-names/.
As this is my first project in Rust, I'm sure there are significant improvements to be made in both the algorithms and implementation. I will gladly accept any constructive criticisms, suggestions or pull requests that make this small project more efficient or accurate.
More specific needs include expanding the library to more languages. To add a language, create a file in the /languages folder with the IETF language tag for the language, in snake_case. Implement the
ordinal_with_format public functions, returning
Strings for each
u64 number. Add a tests module (either separately or in the same file) with tests covering several generic as well as specific edge-cases for the language. Add an option to the
number_names::languages::Language enum with the IETF tag in CamelCase. Send me a pull request with the completed changes once all your tests are passing!
With the release of version 0.2.0 that saw significant refactoring to make the library more extensible for both formatting and languages, my hope is that the API is now relatively stable. I hope developers will open issues or submit enhancements to help strengthen these foundations. I will continue to maintain this library and intend to promote the most current version to 1.0 to signify stability no sooner than 6 months after the most recent breaking change.