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?

Comienza con los ejemplos warnings.deprecated y TYPE_CHECKING del issue y, después, revisa cómo representa la especificación de typing los metadatos de deprecación y las firmas de los decoradores. Se considera terminado cuando se haya acordado un diseño para aceptar metadatos de packaging.Version manteniendo el comportamiento correcto del sistema de tipos; el issue no especifica ningún archivo ni prueba concretos.