Python标记函数或类为废弃(deprecated)并在Pychram或Idea中检测提示删除线

文章目录

      • 前言
      • IDE配置
      • 标记Deprecated示例

前言

在python中,如果你有函数或者类当下没有作用,或者即将废弃,但是你又不想删除,那么你可以标记为deprecated。其实我更想做的是什么?能够让我标记的函数或者类在其它地方使用的时候,能有直观的提示。用Idea做java开发的童鞋肯定很清楚,java代码中的类或者函数只要标记了@Deprecated注解,在所有使用它的地方都会有删除线很直观的标记出来。
那么,PyCharm或者Idea使用Python插件是否也有对Python进行deprecated检测并提示的能力呢?
有!

IDE配置

PyCharm和Idea非常的智能,能识别Python的函数或类是否被标记为deprecated,并展示删除线。
preferences->Editor-inspections,搜索框中输入Deprecated,在Python那类中看是否有勾选住,默认应该是勾选的。
Python标记函数或类为废弃(deprecated)并在Pychram或Idea中检测提示删除线_第1张图片
咱们看描述:

This inspection highlights usages of Python functions, classes or methods which are marked as deprecated (which raise a DeprecationWarning or a PendingDeprecationWarning).

意思是说:检查python的函数、类、或者类函数是否标记了deprecated(抛出DeprecationWarning或者PendingDeprecationWarning警告),如果标记了会高亮(实际是删除线)。

标记Deprecated示例

import warnings


def some_old_function(x, y):
	# 这行告警代码被识别到
    warnings.warn("some_old_function is deprecated", DeprecationWarning)
    return x + y

some_old_function(12, 34)

Python标记函数或类为废弃(deprecated)并在Pychram或Idea中检测提示删除线_第2张图片
关键是warnings.warn("some_old_function is deprecated", DeprecationWarning)这行代码被PyCharm识别到了。
注意,上面只是让IDE能达到识别废弃并使用删除线提示而已。

如果想要生成doc帮助文档的话,可以安装Deprecated模块结合使用。
pip install Deprecated

安装之后像下面这样使用即可:

import warnings

from deprecated.sphinx import deprecated

warnings.filterwarnings("always")


@deprecated(version='1.0', reason="This function will be removed soon")
def some_old_function(x, y):
    warnings.warn("some_old_function is deprecated", DeprecationWarning)
    return x + y


if __name__ == '__main__':
    some_old_function(12, 34)
    help(some_old_function)


Python标记函数或类为废弃(deprecated)并在Pychram或Idea中检测提示删除线_第3张图片
执行之后的结果如下:
在这里插入图片描述
@deprecated注解会更改函数的__doc__属性,可以看到帮助文档被打印了出来。如果想要打印出告警信息的话,需要在前面加上warnings.filterwarnings("always")
这样就能看到打印出来的告警信息了。

你可能感兴趣的:(python,IDEA的使用,python,PyCharm,deprecated,删除线,idea)