simplemma

library1.1.2pypypi✓ verified 89d ago

A lightweight multilingual lemmatization and language detection library for Python. Current version: 1.1.2. Release cadence: irregular, with major breaking changes at v1.0.0. Requires Python >=3.8.

ai-ml data

pip install simplemma

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · SIMPLEMMA

simplemma

ai-mlpythonv1.1.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

lemmatize

✓ from simplemma import lemmatize

✗ import simplemma; simplemma.lemmatize()

Direct import is preferred and more efficient.

is_known_word

✓ from simplemma import is_known_word

No common mistake.

LanguageDetector

✓ from simplemma.language_detector import LanguageDetector

✗ from simplemma.langdetect import LanguageDetector

The submodule was renamed from 'langdetect' to 'language_detector' in v1.0.0.

Basic usage of simplemma for lemmatizing a word with optional greedy mode.

from simplemma import lemmatize # Lemmatize a single word result = lemmatize('running', lang='en') print(result) # 'run' # With greedy mode (more aggressive rule-based lemmatization) result_greedy = lemmatize('better', lang='en', greedy=True) print(result_greedy) # 'good'

Debug

Known issues

breakingThe 'extensive' argument was renamed to 'greedy' in v1.0.0. Using 'extensive' will raise an error.

fix

Replace 'extensive=True' with 'greedy=True'.

affects: >=1.0.0

breakingThe 'langdetect' submodule has been renamed to 'language_detector' in v1.0.0. Old imports will fail.

fix

Use 'from simplemma.language_detector import LanguageDetector'.

affects: >=1.0.0

deprecatedThe 'simplemma.langdetect' submodule is removed in v1.1.2. Old code using it will break.

fix

Migrate to 'simplemma.language_detector' (v1.0.0+) and ensure you are using v1.1.2+.

affects: >=1.1.2

gotchaLemmatization is dictionary-based; unknown words may be returned unchanged. Use 'greedy=True' for more aggressive (rule-based) fallback.

fix

Consider enabling greedy mode or pre-checking with 'is_known_word()'.

affects: all

gotchaLanguage detection requires that you call 'LanguageDetector()' with the appropriate parameters; the old 'langdetect' function from v0.x is not available.

fix

Use 'LanguageDetector().detect(text)' instead of the removed 'simplemma.langdetect'.

affects: >=1.0.0

Errors

Common errors & fixes

AttributeError: module 'simplemma' has no attribute 'langdetect'

The 'langdetect' submodule was renamed to 'language_detector' in v1.0.0 and removed in v1.1.2.

fix

Change import to: 'from simplemma.language_detector import LanguageDetector'

TypeError: lemmatize() got an unexpected keyword argument 'extensive'

The 'extensive' argument was renamed to 'greedy' in v1.0.0.

fix

Use 'greedy=True' instead of 'extensive=True'.

ModuleNotFoundError: No module named 'simplemma.langdetect'

The submodule 'langdetect' has been removed as of v1.1.2.

fix

Use 'from simplemma.language_detector import LanguageDetector'.

ValueError: Wrong language code

Language codes must be lowercase ISO 639-1 codes. Unknown or misspelled codes cause this error.

fix

Check your language code against the list of supported languages (e.g., 'en', 'de', 'fr').

Upgrade

Version history

1.1.2latest on PyPI · released Nov 19, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/adbar/simplemma ↗

packagehttps://pypi.org/project/simplemma/ ↗

docshttps://adbar.github.io/simplemma/ ↗