Python @deprecated decorator for marking old classes, functions, or methods as deprecated. Useful when you want developers to see warnings and optionally provide a reason message, helping guide them to newer alternatives.
Project status
- The project appears actively maintained, with a recent upstream push on 2026-04-22, and ongoing GitHub-tagged updates (latest shown, v1.3.1 on 2025-10-30).
- Update cadence looks moderate and bursts around maintenance, for example, v1.2.15 to v1.2.18 (Nov 2024 to Jan 2025), then v1.3.0 and v1.3.1 within one day (2025-10-29 to 2025-10-30). The most recent shown update, v1.3.1, is largely packaging and versioning metadata.
AI summary generated 2 weeks ago
Recent updates
v1.3.1
7 months agoRelease v1.3.1 mostly updates versioning and packaging-related metadata, plus documentation/changelog plumbing. The provided GitHub release notes do not list any concrete runtime feature or API changes for this version.
v1.3.0
7 months agov1.3.0 introduces parameter-level deprecation via a new `deprecated_params` decorator, along with compatibility work for Wrapt 2.x testing and CI/doc updates. It also updates the project version metadata and expands CI testing to Python 3.13 and 3.14.
Featuresv1.2.18
1/27/2025v1.2.18 is presented as a non-source-code change release, primarily intended to address a Fedora build anomaly. The code diff shows only version and metadata updates across packaging and documentation files, with no functional logic changes.
v1.2.17
1/24/2025Release v1.2.17 primarily updates documentation build and release automation configuration, including ReadTheDocs integration and Sphinx assets. The only runtime package code change shown is the version bump in the deprecated package metadata.
v1.2.16
1/24/2025v1.2.16 is a small maintenance release focused on CI/build automation and documentation configuration. The release notes mention a Packit config update and a documentation compatibility fix for Sphinx 8, plus the version bump.
v1.2.15
11/15/2024v1.2.15 is a bug fix release that focuses on improving deprecation warning behavior and CI coverage for newer Python versions. It adds an `extra_stacklevel` argument to better control where deprecation warnings point, updates class method deprecation warnings for Python 3.13, and updates workflows to include Python 3.12 while dropping deprecated CI systems.
Featuresv1.2.14
5/27/2023v1.2.14 is primarily a maintenance release. It includes a fix for how dedentation is handled for certain long docstring formats used with Sphinx directives, and it updates CI/build configurations to support newer Python versions.
Featuresv1.2.13
9/5/2021v1.2.13 is labeled as a bug fix release. The release notes focus on fixing the public behavior and signatures of the Sphinx integration decorators, plus some CI/test configuration updates.
Breakingv1.2.12
3/13/2021v1.2.12 is a small bug fix release focused on Sphinx documentation integration, specifically deprecation directive formatting and warning message output. It also updates CI/tox configurations to run unit tests on Python 3.10.
Breakingv1.2.11
1/17/2021Release v1.2.11 is a bug fix release focused on Sphinx documentation support and deprecation-warning behavior for the `versionadded` and `versionchanged` decorators. The release notes only document three changes, but the code diff includes additional packaging, CI, and documentation/release tooling adjustments.