-
过去,我主要使用PyLint-它可以突出显示何时使用未定义的变量,何时导入不使用它们的东西等等。
它可能有点冗长,抱怨诸如行长超过80个字符,变量与特定正则表达式不匹配,类的公共方法太少,方法缺少docs-trings之类的问题。
例如对于脚本。
import os import somefakelib def myfunc(x): blah = "Something" print os.listdir( x+blh )
PyLint生成以下消息:
C: 1: Missing docstring F: 2: Unable to import 'somefakelib' (No module named somefakelib) C: 4:myfunc: Missing docstring C: 4:myfunc: Invalid name "x" (should match [a-z_][a-z0-9_]{2,30}$) C: 4:myfunc: Invalid name "x" (should match [a-z_][a-z0-9_]{2,30}$) E: 6:myfunc: Undefined variable 'blh' W: 5:myfunc: Unused variable 'blah' W: 2: Unused import somefakelib
它们都是有效的投诉,但是我倾向于禁用许多约定和重构消息。您可以禁用特定消息,作为代码中的注释:
#pylint:disable-msg=R0903,C0103,R0903,F0401,C0301
..或作为PyLint命令的命令行参数:
pylint --disable-msg=R0903,C0103,R0903,F0401,C0301 myfile.py
在禁用以上消息的情况下,它将为以上代码生成以下消息:
C: 1: Missing docstring C: 4:myfunc: Missing docstring E: 6:myfunc: Undefined variable 'blh' W: 5:myfunc: Unused variable 'blah' W: 2: Unused import somefakelib
PyLint还会生成一个“代码报告”,包括文件包含多少行代码/注释/文档字符串/空格,每个类别的消息数,并为您的代码提供“分数”-10表示无消息,0表示语法错误
另一个选择是PyFlakes,我发现它不太冗长(我最近开始使用它代替PyLint)。再次使用上述脚本,PyFlakes给出以下消息:
example.py:2: 'somefakelib' imported but unused example.py:6: undefined name 'blh'
我使用的最后一个选项是
pep8.py
,顾名思义,它强制执行PEP8。它是迄今为止最多的学究脚本,它强制执行诸如在函数/类之前/之后正确的空白行,代码周围的间距,正确的4位空格缩进等之类的事情。在上面的代码上运行,它将产生以下结果:
example.py:4:1: E302 expected 2 blank lines, found 1 example.py:6:23: E201 whitespace after '(' example.py:6:32: W292 no newline at end of file
它主要用于强制执行诸如正确的空格之类的样式操作,对诸如PyLint或PyFlakes之类的代码不做太多静态分析,因此我将pep8.py与PyLint或PyFlakes结合使用。
pep8.py
最初是在此处的python邮件列表中宣布的,但是其中的下载链接现在已经消失了。从版本的旧版本PyChecker是另一种选择,尽管我没有使用过