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?

Inizia con gli esempi warnings.deprecated e TYPE_CHECKING dell’issue, quindi esamina come la specifica di typing rappresenta i metadati di deprecazione e le firme dei decorator. Il lavoro è completato quando è stato concordato un design per accettare i metadati packaging.Version preservando il corretto comportamento del sistema dei tipi; l’issue non indica alcun file o test specifico.