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
- Actively maintained: The upstream GitHub source shows a new push on 2026-10-01, and there was a recent v3.0.0 update on 2026-09-26, indicating current development activity.
- Update cadence: There was a long gap from late 2025 to late 2026 (most previous updates in 2025-10, then next major update in 2026-09). After the recent major modernization, updates appear recent again, but overall the cadence looks bursty rather than continuous.
AI summary generated
Recent updates
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.