deprecation 2.0.7

折旧

deprecation库提供了一个deprecated装饰器和 fail_if_not_removeddecorator用于您的测试。两个人在一起 实现以下几点的自动化：

1. 已弃用方法的docstring获取弃用详细信息 附在它的末尾。如果直接生成api文档 从你的来源来看，你不需要担心自己的 通知。你也不必担心忘记 写下来。这是为你做的。
2. 而不是因为你不赞成 但从来没有离开过，你可以做你的测试 告诉你什么时候该删除代码。那@deprecated 可以告诉decorator何时该完全删除代码， 这会导致@fail_if_not_removed引发AssertionError， 导致unittest或py.test测试失败。

有关完整文档，请参见http://deprecation.readthedocs.io/。

安装

pip install deprecation

用法

import deprecation

@deprecation.deprecated(deprecated_in="1.0", removed_in="2.0",
                        current_version=__version__,
                        details="Use the bar function instead")
def foo():
    """Do some stuff"""
    return 1

…但是python不忽略DeprecationWarning？

是的，从2.7开始就默认了，这是有充分理由的[1]-而且这工作得很好 带着这个。

1. 使用-W标志或 PYTHONWARNINGS环境变量，以便捕捉警告 在开发中，并妥善处理。提出的警告 这个库出现在那里，因为它们是内置的子类 DeprecationWarning。见Command Line 和Environment Variable 有关更多详细信息的文档。
2. 即使你不启用这些功能，这个库的行为 保持不变。docstring仍将被更新，测试 当他们需要的时候仍然会失败。不管怎样你都会得到好处的 python关心的是DeprecationWarning。