Pronouncing

0.2.0 · active · verified Tue Apr 14

Pronouncing is a lightweight Python library providing a simple interface to the CMU Pronouncing Dictionary. It allows users to programmatically access phonetic pronunciations, find rhyming words, count syllables, and search for words based on phonetic patterns. The current version is 0.2.0, with releases historically being infrequent, the last major update in 2018.

Warnings

breaking Version 0.2.0 removed the CMU Pronouncing Dictionary data directly from the package. It now relies on the `cmudict` package as a dependency to provide this data. If upgrading from an older version (pre-0.2.0), ensure `cmudict` is installed.
Fix: Ensure `cmudict` is installed alongside `pronouncing`. `pip install pronouncing` should handle this, but manual intervention might be needed for older environments or direct source installations. `pip install cmudict`
gotcha The `pronouncing.phones_for_word()` function can return multiple pronunciations for a single word, reflecting different possible ways a word can be spoken. The library does not provide built-in logic to determine the 'best' or 'most common' pronunciation.
Fix: Applications using `phones_for_word()` should implement their own criteria for selecting the appropriate pronunciation from the returned list, based on their specific use case (e.g., always taking the first, or applying a custom ranking).
gotcha The library's development seems to be low-activity, with the last release (0.2.0) in 2018. While functional, new features or active maintenance should not be expected.
Fix: Be aware of the library's maintenance status. For projects requiring active development, frequent updates, or new linguistic features, consider alternatives or be prepared to fork and maintain the library yourself.

Install

pip install pronouncing Install Pronouncing

Imports

pronouncing
```
import pronouncing
```

Quickstart

This quickstart demonstrates how to find rhymes, retrieve phonetic pronunciations in ARPAbet, and count syllables for a given word using the `pronouncing` library.

import pronouncing

word = "climbing"
rhymes = pronouncing.rhymes(word)
print(f"Rhymes for '{word}': {rhymes}")

pronunciations = pronouncing.phones_for_word(word)
print(f"Pronunciations for '{word}': {pronunciations}")

syllables = pronouncing.syllable_count(pronunciations[0]) # Use the first pronunciation for syllable count
print(f"Syllable count for '{word}': {syllables}")

view raw JSON →