Inflect

7.5.0 · active · verified Sun Mar 29

Inflect.py is a Python library designed to correctly generate plurals, singular nouns, ordinals, indefinite articles (a/an), and word-based representations of numbers. Its functionality is primarily focused on the English language. As of version 7.5.0, it maintains an active development and release cadence, with regular updates addressing features, bug fixes, and compatibility.

Warnings

breaking Version 7.0.0 removed methods that were renamed in an earlier 0.2.0 release. If your code uses very old aliases, they will cease to function.
Fix: Refer to the `inflect` documentation for current method names and update your code accordingly. These typically involve methods for singular/plural inflection.
gotcha When using methods like `plural_noun()`, ensure you pass the *singular* form of the word. Similarly, `singular_noun()` expects the *plural* form. Passing the incorrect base form can lead to undefined or incorrect inflections.
Fix: Always provide the correct base form (singular for pluralization, plural for singularization) to the respective `inflect.engine()` methods.
gotcha Older versions (pre-7.2.0, particularly in the v6.x series) experienced compatibility issues with Pydantic, leading to `ValueError` (e.g., `ValueError: Field default cannot be set in Annotated`). This was often due to Pydantic 1 vs. 2 conflicts. While v7.2.0 replaced Pydantic with Typeguard, users with existing Pydantic installations in their environment might still encounter conflicts if older `inflect` versions are used or if a new conflict arises.
Fix: Upgrade `inflect` to the latest v7.x version. If issues persist, ensure your environment's Pydantic (if present) and `inflect` versions are compatible, or isolate `inflect` in a separate virtual environment.
gotcha For combining multiple inflections within a single string, the `p.inflect()` string-interpolating method is generally more readable and efficient than concatenating multiple method calls.
Fix: Consider using `print(p.inflect('num({0}) plural_noun(error) plural_verb(was) detected.'.format(errors)))` instead of `print(p.num(errors), p.plural_noun(' error'), p.plural_verb(' was'), ' detected.')`.

Install

pip install inflect Install latest version

Imports

engine
```
import inflect
p = inflect.engine()
```
The primary way to interact with the library is through an instance of the engine class.

Quickstart

This quickstart demonstrates common `inflect` functionalities: pluralizing nouns conditionally, generating ordinal numbers, converting numerals to words, and selecting indefinite articles ('a' or 'an').

import inflect

p = inflect.engine()

# Pluralization
word = 'cat'
count = 5
print(f"The plural of '{word}' is '{p.plural(word)}'")
print(f"I saw {count} {p.plural_noun(word, count)}.")

# Ordinal numbers
number = 21
print(f"The ordinal of {number} is {p.ordinal(number)}")

# Numbers to words
big_number = 1234567
print(f"'{big_number}' in words is '{p.number_to_words(big_number)}'")

# Indefinite articles
print(f"An apple and {p.an('historical object')}")

view raw JSON →