---
id: deprecation-alias
version: "0.4.0"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# deprecation-alias — A wrapper around 'deprecation' providing support for deprecated aliases.

License: permissive · Maintenance: active · Downloads: 762.2K/mo

## 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 above — 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

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

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 762.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

deprecated function aliases, deprecation warnings wrapper, manage deprecated names, function alias deprecation, legacy name handling, api-deprecation, backward-compatibility

[View on SkillFed](https://skillfed.io/packages/deprecation-alias) · [View on PyPI](https://pypi.org/project/deprecation-alias/)