deprecation

A library to handle automated deprecations

deprecation Permissive license Apache 2 Abandoned ★ 95 v2.1.0 released 2020-04-20

Install

deprecation on PyPI

pip

pip install deprecation

uv

uv add deprecation

poetry

poetry add deprecation

Package facts

License	Apache 2 (permissive)
Python support	not specified
Install friction	low — pure-Python wheel
Runtime dependencies	1 — packaging
Maintenance	abandoned — 2,306 days since the last release
Last repo commit	2023-04-11
First released	2017-01-23
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: deprecation-2.1.0-py2.py3-none-any.whl

Keywords: deprecation

Development Status :: 5 - Production/StableLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Libraries :: Python Modules

About deprecation

from the package's own PyPI description — quoted content, verbatim

deprecation

.. image:: https://readthedocs.org/projects/deprecation/badge/?version=latest :target: http://deprecation.readthedocs.io/en/latest/ :alt: Documentation Status

.. image:: https://travis-ci.org/briancurtin/deprecation.svg?branch=master :target: https://travis-ci.org/briancurtin/deprecation

.. image:: https://codecov.io/gh/briancurtin/deprecation/branch/master/graph/badge.svg :target: https://codecov.io/gh/briancurtin/deprecation

The deprecation library provides a deprecated decorator and a fail_if_not_removed decorator for your tests. Together, the two enable the automation of several things:

The docstring of a deprecated method gets the deprecation details appended to the end of it. If you generate your API docs direct from your source, you don't need to worry about writing your own notification. You also don't need to worry about forgetting to write it. It's done for you.
Rather than having code live on forever because you only deprecated it but never actually moved on from it, you can have your tests tell you when it's time to remove the code. The @deprecated decorator can be told when it's...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides decorators to automate deprecation warnings and enforce removal timelines in Python code, automatically updating docstrings and failing tests when deprecated code should be removed.

Low install friction with a single lightweight dependency (packaging). However, the package is abandoned—last release was 2020-04-20, with no recent maintenance activity despite an active repository.

Licensed under Apache 2 (permissive), allowing commercial and private use with minimal restrictions, though you assume responsibility for any future maintenance if the project remains unmaintained.

Usage

pip install deprecation

import deprecation

@deprecation.deprecated(deprecated_in="1.0", removed_in="2.0",
                        current_version="1.5",
                        details="Use bar() instead")
def foo():
    return 1

Verdict: Stable and production-ready for basic deprecation workflows, with no known vulnerabilities and permissive licensing. However, the package has been abandoned since 2020-04-20 and will not receive updates, making it a maintenance risk for new projects or those requiring ongoing support.

Needs verification

Whether the package remains compatible with Python versions released after the latest release date of 2020-04-20
Whether there are actively maintained alternatives that provide similar deprecation automation
Whether the single dependency (packaging) itself receives ongoing security updates

deprecation decorator pythonautomated deprecation warningsenforce code removal timelinedeprecation testing helpersmark functions as deprecatedfail if not removed decoratordeprecation lifecycle management