PyChecker:Python代码静态分析工具

1 概述

PyChecker是Python代码的静态分析工具,它能够帮助查找Python代码的bug,而且能够对代码的复杂度和格式等提出警告。

PyChecker可以工作在多种方式之下。首先,PyChecker会导入所检查文件中包含的模块,检查导入是否正确,同时检查文件中的函数、类和方法等。

推荐阅读:

Ubuntu 14.04安装Python 3.3.5 

PyChecker可以检查出来的问题有如下几种:

  • 全局量没有找到,比如没有导入模块
  • 传递给函数、方法、构造器的参数数目错误
  • 传递给内建函数和方法的参数数目错误
  • 字符串格式化信息不匹配
  • 使用不存在的类方法和属性
  • 覆盖函数时改变了签名
  • 在同一作用域中重定义了函数、类、方法
  • 使用未初始化的变量
  • 方法的第一个参数不是self
  • 未使用的全局量和本地量(模块或变量)
  • 未使用的函数/方法的参数(不包括self)
  • 模块、类、函数和方法中没有docstring

2 使用

--------------------------------------------------------------------------------

从官网下载最新版本的PyChecker之后,解压安装即可:python setup.py install

首先可以在解压后的目录中测试一番:

[root@rango pychecker-0.8.19]# pychecker setup.py

Processing module setup (setup.py)...

Warnings...

[system path]/distutils/command/bdist_wininst.py:271: Statement appears to have no effect

[system path]/distutils/command/build_scripts.py:80: No class attribute (dry_run) found

[system path]/distutils/command/build_scripts.py:97: No class attribute (dry_run) found

[system path]/distutils/command/build_scripts.py:120: (file) shadows builtin

[system path]/distutils/command/build_scripts.py:121: No class attribute (dry_run) found

[system path]/distutils/command/install_data.py:62: (dir) shadows builtin

[system path]/distutils/command/install_data.py:64: (dir) shadows builtin

[system path]/distutils/command/install_data.py:66: (dir) shadows builtin

[system path]/distutils/command/install_scripts.py:52: (file) shadows builtin

[system path]/distutils/command/install_scripts.py:53: No class attribute (dry_run) found

19 errors suppressed, use -#/--limit to increase the number of errors displayed

可以看到,检查的结果将setup.py依赖的一些文件中的语法错误或者警告都列举出来了,使用--only参数可以只检查自身的语法问题:

[root@rango pychecker-0.8.19]# pychecker --only setup.py

Processing module setup (setup.py)...

Warnings...

None

参数和选项说明:pychecker [options] file1.py file2.py ...

--only        只给出命令行的文件的警告,默认为no

-#,--limit    显示的最大警告数,默认为10

--no-shadowbuiltin    检查是否有变量覆盖了内建变量,默认为off

-q,--stdlib        忽略标准库的文件的警告,默认为off

-T,--argSUSEd    未使用的方法/函数的关键字,默认为on

修改默认配置和行为:.pycheckrc文件,该文件放置在$HOME目录下,--rcfile选项可以生成一份默认的配置文件。

要禁止一些模块/函数/类/方法的警告信息,可以在.pycheckrc文件中定义一个禁止字典,键类似:

‘module’,‘module.function’,'module.class'等。

或者直接在代码中定义:

__pychecker__ = 'no-namedargs maxreturns=0 unsednames=foo,bar'

其中__pychecker__格式的值和在禁止字典中的值是一样的

在代码文件中导入PyChecker模块及使用:

import pychecker.checker

这将会检查所有在PyChecker之后导入的模块,之前的不检查。

如果不能传递命令行参数,可以使用:

os.environ['PYCHECKER'] = 'command line options here'

等价于在shell环境中设置PYCHECKER:

PYCHECKER='no-namedargs maxreturns=0' /path/to/your/program

要关闭警告,可以在导入PyChecker之前,加上:

os.environ['PYCHECKER_DISABLED'] = 1

等价于在shell环境中设置PYCHECKER_DISABLED:

PYCHECKER_DISABLED=1 /path/to/your/program

相关推荐