deprecated is becoming an official decorator

[12rambau]

I just wanted to notify you that PEP-702 introduces support for an official @deprecated() decorator (https://peps.python.org/pep-0702/).

Are you planning on relying on it for the deprecated decorator ?

[bswck]

In other words, the @deprecated decorator is now officially deprecated.

[12rambau]

no not exactly as the deprecated decorator they introduced is not setting the version reason and is not compatible with Sphinx which to me are 2 huge downgrades. It goes without saying that versionadded and versionmodified remain completely not deprecated.

[dimaqq]

I'm in the market for @deprecated backport, but it has to have same (or compatible) signature to the upcoming Py 3.13 version.

[flying-sheep]

A backport exists: https://github.com/python/typing_extensions/blob/main/CHANGELOG.md#release-490-december-9-2023

diff --git a/pyproject.toml b/pyproject.toml
index cfb7ffd2..324c4c42 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -66,6 +66,7 @@ dependencies = [
     "...",
+    "typing-extensions; python_version < '3.13'",
 ]

and then

if sys.version_info >= (3, 13):
    from warnings import deprecated
else:
    from typing_extensions import deprecated