[Deprecated] Update to ~=1.3.1 (#14954)

Author: donbarbos

stubs/Deprecated/METADATA.toml

@@ -1,3 +1,3 @@
-version = "~=1.2.15"
+version = "~=1.3.1"
 upstream_repository = "https://github.com/tantale/deprecated"
 requires = []

stubs/Deprecated/deprecated/__init__.pyi

@@ -1,4 +1,9 @@
+from typing import Final
+
 from .classic import deprecated as deprecated
+from .params import deprecated_params as deprecated_params
 
-__credits__: str
-__date__: str
+__version__: Final[str]
+__author__: Final[str]
+__date__: Final[str]
+__credits__: Final[str]

stubs/Deprecated/deprecated/params.pyi

@@ -0,0 +1,20 @@
+from collections.abc import Callable, Iterable
+from inspect import Signature
+from typing import Any, TypeVar
+from typing_extensions import ParamSpec
+
+_P = ParamSpec("_P")
+_R = TypeVar("_R")
+
+class DeprecatedParams:
+    messages: dict[str, str]
+    category: type[Warning]
+    def __init__(self, param: str | dict[str, str], reason: str = "", category: type[Warning] = ...) -> None: ...
+    def populate_messages(self, param: str | dict[str, str], reason: str = "") -> None: ...
+    def check_params(
+        self, signature: Signature, *args: Any, **kwargs: Any  # args and kwargs passing to Signature.bind method
+    ) -> list[str]: ...
+    def warn_messages(self, messages: Iterable[str]) -> None: ...
+    def __call__(self, f: Callable[_P, _R]) -> Callable[_P, _R]: ...
+
+deprecated_params = DeprecatedParams