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 is actively maintained now, with an upstream push on 2026-11-01 and updates in September and October 2026.
- Cadence has been uneven: after updates in October 2025 and January 2025, there was a long gap before the recent burst of activity.
AI summary generated
Recent updates
v3.0.1
v3.0.1 fixes constructor-signature introspection for deprecated classes, including signatures shown by Sphinx autodoc. It also refreshes development dependencies and adds a repository social preview image with documented release steps.
v3.0.0
v3.0.0 is a major modernization release, moving the project to Python 3.12+ and updating the build and CI toolchain to use uv and Hatch. It also adds new docstring decorator modules for Google and NumPy styles, and includes a fix so deprecated callables can be pickled for multiprocessing.
BreakingFeaturesv1.3.1
Release 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
v1.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
v1.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
Release 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
v1.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
v1.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
v1.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
v1.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
v1.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
Release 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.