如何正式弃用一个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