pluralio¶
Pluralization and singularization for Python — zero dependencies, type-safe, extensible.
Supports English, Spanish, Portuguese, French, Italian, and Esperanto.
Installation¶
pip install pluralio
Quick start¶
from pluralio import pluralize, singularize
pluralize("cat") # "cats"
pluralize("gato", lang="es") # "gatos"
pluralize("libro", lang="eo") # "libroj"
singularize("cities") # "city"
singularize("lápices", lang="es") # "lápiz"
# Count-aware
pluralize("item", count=1) # "item"
pluralize("item", count=5) # "items"
# Case preservation
pluralize("Library") # "Libraries"
pluralize("LIBRARY") # "LIBRARIES"
# Hyphenated words
pluralize("mother-in-law") # "mothers-in-law"
Documentation¶
Guides
- Usage Guide
- Cookbook
- Pluralizing a list of words
- Count-aware UI labels
- Multi-language support
- Adding domain-specific vocabulary
- Marking words as uncountable
- Custom regex rules for a domain
- Registering a mini-language
- Test isolation with snapshot/restore
- Checking word forms
- Joining words into a list
- Converting numbers to ordinals
- Template interpolation
- Supported Languages
API Reference
Project