synnamon 0.2.0

Pure Python package for getting synonyms for words.

A simple Python package that looks up synonyms for words.

Synnamon: Offline synonyms for English words (Python 3.8+)

What is it?

Synnamon is a simple Python package that looks up synonyms using a built in thesaurus shelve file instead of reaching out to web resources (PyDictionary) or using large English lexical databases (nltk WordNet).

Where to get it

Source code: https://github.com/eddiethedean/synnamon

# PyPI
pip install synnamon

Requirements

• Python 3.8+
• Dependency: inflex (used to convert plural word lookups to singular and then convert singular synonym results to plural)

Usage

import synnamon

syns = synnamon.get_syns('jump')
print(syns.get('verb', [])[:5])

Behavior

• Input is normalized to lowercase and trimmed.
• If the plural form is not found, get_syns will try the singular form and pluralize only the noun synonyms.
• Returns {} for unknown words or empty/whitespace input.

API

from synnamon import get_syns

def get_syns(word: str) -> dict:
    """Get synonyms for a word from the built-in thesaurus."""

Development

Run tests with pytest:

pytest -q

Test configuration lives in pyproject.toml and collects coverage for synnnamon.