How to extend `warnings.deprecated`?

We need more metadata for our deprecation decorator, but the spec doesn’t say how deprecated marks an API. So the only way to mark something as deprecated it is by creating an API with the same exact signature and replace it with warnings.deprecated at the type level:

if TYPE_CHECKING:
    from warnings import deprecated
else:
    def deprecated[F](msg: str) -> Callable[[F], F]: ...

We need to define deprecated(msg: str, version: packaging.Version) and have it work with the type system. How?

Commencez par les exemples warnings.deprecated et TYPE_CHECKING de l’issue, puis examinez comment la spécification de typing représente les métadonnées de dépréciation et les signatures des décorateurs. Le travail est considéré comme terminé lorsqu’un design accepté pour prendre en charge les métadonnées packaging.Version tout en préservant le comportement correct du système de types a été défini ; l’issue ne nomme aucun fichier ni test spécifique.