如何正式弃用 pip 包

Question

这可能看起来有点奇怪，但在谷歌搜索了一段时间后，我真的找不到可以接受的方法。

基本上我有一个我维护的 pip 包。它主要是外部 API 的包装器，而外部 API 刚刚更改。我发送了一个新版本的包装器，但大概不是每个人都保持他们的 pip 包完全最新。我努力保留大部分遗留功能，但有一些功能我无法保留。

有什么方法可以正式让人们知道某个版本之前的每个包都已被正式弃用？理想情况下，这会告诉人们积极升级，但我不确定这是否可行。

似乎 pip 必须为此提供一些功能或最佳实践，但我真的找不到任何相关文档。

Answer 1

如果您希望模块在其他地方import 时发出警告，请将以下代码添加到模块的__init__.py。

import warnings
warnings.warn("deprecated", DeprecationWarning)

发件人：https://docs.python.org/2/library/warnings.html#temporarily-suppressing-warnings