---
id: deprecation
version: "2.1.0"
license: Apache 2
license_treatment: permissive
maintenance: abandoned
---

# deprecation — A library to handle automated deprecations

License: permissive · Maintenance: abandoned · Popularity: top 1,000 on PyPI

## Install

pip install deprecation
uv add deprecation
poetry add deprecation

## Description

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:

1. 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.
2. 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...

## AI interpretation — verify before relying

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.

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.

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