contractions
Fixes contractions such as `you're` to you `are`
Decision gist · record as of 2026-08-14
Yes, if you need lightweight contraction expansion and can accept an abandoned package. The library is simple, has no known vulnerabilities, and low install friction. However, verify that textsearch remains compatible with your Python version, and consider whether the lack of maintenance poses a risk for your use case—bug fixes or Python version updates will not be forthcoming.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low friction: pure Python wheel with a single runtime dependency.
- However, the package is abandoned—last commit was 2022-11-15.
- The description notes versions >0.0.18 are 50x faster, suggesting older releases had performance issues; verify you have a recent enough version.
License · maintenance · safety
MIT (permissive) — MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.
last release 2022-11-15 (1368 days) · last repo commit 2022-11-15 · 318 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 588,160 downloads/mo, #5,869 on PyPI
Alternatives
Verify before relying
pip install contractions
import contractions
result = contractions.fix("you're happy now")
print(result) # "you are happy now"- Whether the runtime dependency textsearch is actively maintained and compatible with current Python versions
- Whether the 50x performance improvement claim in the description applies to version 0.1.73 specifically
- Python version compatibility given the package targets Python 2.7 and 3.4-3.6 but has not been updated since 2022-11-15
What it is and what it does
Contractions is a text preprocessing library that converts English contractions and informal speech patterns into their expanded forms. It handles common cases like "you're" → "you are" and "gotta" → "got to", and resolves ambiguous cases by choosing the most common interpretation (e.g., "he's" becomes "he is" rather than "he has"). The package includes a slang mode (enabled by default) that expands informal patterns like "ima" and "yall", and allows users to register custom expansion rules.
The library depends on textsearch for pattern matching and is distributed as a pure Python wheel with low installation friction. It targets NLP preprocessing workflows where normalized text is needed for downstream analysis or model training. The package is no longer actively maintained, with the last release on 2022-11-15.
Use it for
- Normalize user-generated text before feeding it to NLP models or text classifiers
- Preprocess social media or chat data where contractions and slang are common
- Expand contractions in customer service transcripts for consistent text analysis
- Prepare training data for language models by standardizing contraction forms
- Add domain-specific contraction rules for specialized text processing pipelines
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need lightweight contraction expansion and can accept an abandoned package.
The library is simple, has no known vulnerabilities, and low install friction. However, verify that textsearch remains compatible with your Python version, and consider whether the lack of maintenance poses a risk for your use case—bug fixes or Python version updates will not be forthcoming.
Install
contractions on PyPI
Before you install
Low friction: pure Python wheel with a single runtime dependency. However, the package is abandoned—last commit was 2022-11-15. The description notes versions >0.0.18 are 50x faster, suggesting older releases had performance issues; verify you have a recent enough version.
License in practice
MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.
Quickstart
pip install contractions
import contractions
result = contractions.fix("you're happy now")
print(result) # "you are happy now"Verify before relying
- Whether the runtime dependency textsearch is actively maintained and compatible with current Python versions
- Whether the 50x performance improvement claim in the description applies to version 0.1.73 specifically
- Python version compatibility given the package targets Python 2.7 and 3.4-3.6 but has not been updated since 2022-11-15
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetextsearch |
| Maintenance | Abandoned 1,368 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 588,160 / month, #5,869 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: Customer ServiceIntended Audience :: DevelopersIntended Audience :: System AdministratorsOperating System :: MacOS :: MacOS XOperating System :: MicrosoftOperating System :: POSIXOperating System :: UnixProgramming Language :: PythonProgramming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Topic :: Software DevelopmentTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python ModulesTopic :: System :: Software DistributionTopic :: System :: Systems AdministrationTopic :: Utilities |
Evidence: contractions-0.1.73-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “expand contractions”
- contractionsExpands English contractions and slang into their full forms (e.g.,…
- cutensor-cu12cuTENSOR is a CUDA library for high-performance tensor operations on…
- bracexBracex expands Bash-style brace patterns into lists of strings,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also textsearch · opt-einsum · parameter-expansion-patched · braceexpand · num2words · expandvars · pyuca · bracex · match · wetext