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?

Bắt đầu với các ví dụ warnings.deprecated và TYPE_CHECKING trong issue, sau đó xem xét đặc tả typing biểu diễn siêu dữ liệu deprecation và chữ ký decorator như thế nào. Được xem là hoàn tất khi đạt được thiết kế đã thống nhất để chấp nhận siêu dữ liệu packaging.Version đồng thời vẫn duy trì hành vi chính xác của hệ thống kiểu; issue không nêu tệp hoặc bài kiểm thử cụ thể nào.