deprecation-alias

What it is and what it does

deprecation-alias is a thin wrapper around the deprecation library that adds first-class support for marking deprecated aliases—old names for functions, classes, or other objects that have been renamed or replaced. Instead of manually crafting deprecation warnings for each alias, you use deprecation-alias to declare that an old name is an alias for a new one, and it handles emitting the appropriate warning when the old name is used.

The package is designed for library maintainers who need to support legacy function or class names while guiding users toward the current API. It depends on deprecation and packaging, both common and stable libraries, and supports Python 3.6 through 3.12 on CPython and PyPy. The codebase is actively maintained and carries no known security vulnerabilities.

Use it for:

• Rename a function in your library while keeping the old name working with a deprecation warning for backward compatibility.
• Provide multiple names for the same class to support different naming conventions across API versions.
• Gradually migrate users away from legacy function names by issuing clear, standardized warnings when old names are called.
• Maintain a stable public API surface while refactoring internal names and organization.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a wrapper around the deprecation library to mark and manage deprecated function and class aliases with standardized warnings.

Yes, if you maintain a library and need to deprecate old function or class names gracefully. The package is lightweight, actively maintained, permissively licensed, and has no security issues. Install it when backward compatibility and clear migration paths matter for your users.

Install

deprecation-alias on PyPI

pip install deprecation-alias

uv add deprecation-alias

poetry add deprecation-alias

Installing deprecation-alias

Before you install

Low install friction with only two lightweight runtime dependencies (deprecation and packaging). Active maintenance with a recent release in February 2025 and last commit in July 2026.

License in practice

Apache License 2.0 is permissive; you may use, modify, and redistribute this package freely in commercial and private projects, provided you include the license and document any changes.

Quickstart

pip install deprecation-alias

from deprecation_alias import deprecated_alias

@deprecated_alias(old_name='old_function', new_name='new_function')
def new_function():
    pass

Verify before relying

• Whether the package provides decorators, context managers, or other specific API patterns for marking aliases
• How the wrapper extends or simplifies the underlying deprecation library's functionality beyond alias support

Package facts

Evidence: deprecation_alias-0.4.0-py3-none-any.whl

Keywords: deprecation

Tags

More Python Modules packages