如何在 Python 中将整个文件标记为已弃用？

Question

我正在查看一个没有类的 .py 文件，只有一个函数列表。现在使用同一文件的更新版本来代替旧文件。

我知道将类或函数标记为已弃用，可以这样做

from warnings import deprecated

然后用于装饰函数或类使用

deprecated("Do not use this")

不存在一一对应关系，因此将所有函数单独标记为已弃用似乎很奇怪。我可以将代码包装在一个类中，弃用这个新创建的类，然后就可以完成它了。但是，在页面顶部有一个注释说明文件的全部内容将被忽略，这并不更自然。

我还可以创建一个新包（例如已弃用），然后将其移动到那里，但我宁愿将代码保留在其原始位置。

那么有没有一种Python式的方法来将整个文件标记为已弃用？

Answer 1

您可以在文件顶部提出 DeprecationWarning。所以每次导入都会发出。