Flake8 是由Python官方发布的一款辅助检测Python代码是否规范的工具,相对于目前热度比较高的Pylint来说,Flake8检查规则灵活,支持集成额外插件,扩展性强。Flake8是对下面三个工具的封装:
1)PyFlakes:静态检查Python代码逻辑错误的工具。
2)Pep8: 静态检查PEP8编码风格的工具。
3)NedBatchelder’s McCabe :静态分析Python代码复杂度的工具。
不光对以上三个工具的封装,Flake8还提供了扩展的开发接口。
官方文档:https://pypi.python.org/pypi/flake8/
安装
这里介绍两种安装方法:
1.在Ubuntu 16.04安装Flake8。
apt-get update
apt-get install python-flake8
2.在Windows安装Python之后,打开cmd,通过命令:
python -m pip install flake8
其中,代表着Python的版本号,可通过python –v或者python –version进行查看。
当然也可以直接按默认配置安装Flake8:
python -m pip install flake8
可通过flake8 –help查看是否安装成功。
建议还是按照Python版本号来镜像安装,Windows下以默认安装形式做静态代码检查,会检测到与Python3一些冲突的地方,如下:
使用方法
文件结构如下:
1.检查指定文件:Flake8 + Python项目名,标红框表示通过Flake8默认配置检测出来的问题。
从红色方框中可以看到 Flake8检测到了四个errors,归类为H101、H233、F821,H开头的是安装hacking插件后检测出来的错误,Flake8基础错误返回码一共有三类:
E***/W***: PEP8中的error和warning。
F***: 通过PyFlakes检测出的error,其实PyFlakes本身是不提供错误返回码的,flake8对pyflakes返回的错误消息进行了分类。
C9**: 通过McCabe检测出的代码复杂度。Flake8提供一个扩展选项:--max-complexity,如果函数的McCabe复杂度比给定的值更高将发出一个告警。该功能对于发现代码过度复杂非常有用,根据Thomas J. McCabe, Sr(Cyclomaticcomplexity的创造者)研究,代码复杂度不宜超过10,而Flake8官网建议值为12。
2.展示特定错误
假如静态代码检查中想展示项目下的H233特定错误怎么办呢?可以通过flake8 --select命令来实现:
flake8 --select H233 shadowtest
如果需要选择以特定类型开头的错误码,eg:以E开头
flake8 --select E shadowtest
如果需要选择多个特定错误码用逗号隔开就可以了,eg:错误码1,错误码2。
3.忽略特定错误码
静态代码检查忽略H233类型错误,设定多个忽略方法同上
flake8 --ignore H233 shadowtest
4.忽略特定文件/文件夹
静态代码检查忽略test2.py文件,设定多个忽略方法同上
flake8 --exclude shadowtest/path2/test2.py shadowtest
静态代码检查忽略path2整个文件,设定多个忽略方法同上
flake8 --exclude shadowtest/path2/shadowtest
5.输出修改格式
flake8 --format=%(path)s::%(row)d,%(col)d::%(code)s::%(text)s shadowtest
假如想把代码复杂度设为其他值,只看几种类型的错误,并且有几个文件夹下的内容不需要检查是不是每次检查都要把上面的设置重新输入一遍?解决如下:配置文件。
Flake8它是支持将个人设定保存在配置文件里面的,我们可以通过以setup.cfg, tox.ini, 或者.flake8以上三种文件形式保存配置。
以tox.ini为例:
输出结果前后对比:
未加入配置前:
加入tox.ini配置后:
假如ignore里面包含H101,但是select也包含H101怎么办?
经过试验:select的优先级比ignore高,两者都含有相同的错误类型下,ignore的这一错误类型的检查会被忽略掉。
假如存在多个配置文件,怎么处理?
可以通过flake8 --config=配置文件项目名称,这种方式解决。
6.通过setup.py检查工程中所有的python文件
关于setup.py相关概念参考这篇文章:http://lingxiankong.github.io/blog/2013/12/23/python-setup/
7.配置其他
关于Flake8更多命令参考:flake8 –help
Flake8的小插件
Flake8相比其他Python静态代码检查工具的优势在于其良好的扩展性,以下是介绍Flake8几款比较流行的插件:
1.hacking
由于Python是OpenStack的官方语言,hacking则是根据OpenStack Style Guidelines所产生,基于原有的Google Python Style Guide和OpenStack自有规则而形成的。hacking官方文档:https://pypi.python.org/pypi/hacking
插件安装也非常简单,通过pip安装hacking,Windows cmd窗口执行:
python –m pip install
hackinghacking插件安装完成之后,会新增一类错误返回码以H开头:H***:hacking返回的错误类型。
在hacking中有些错误类型检测是默认关闭的,可以通过命令行或者配置文件修改开关:enable-extensions= H106,H203
2.pep8-naming
针对目前pep8尚未支持命名规范的检查,有人开发出了此款插件作为规则补充。
pep8-naming插件安装完成之后,会新增一类错误返回码以N开头:
N***: pep8-naming返回的错误类型。
其他插件可以通过命令:pip search flake8来搜索,肯定有你需要的,安装也非常简单:pip install 插件名称
有些坑先提示一下:
规则检查插件与插件之间,可能会存在重复提示,假如要排除一类则你的配置文件会越来越复杂,并不是安装越多越好,工具不在于过多,而在于会用。
插件与插件之间,尤其是两个新的插件可能无法完美兼容。eg:为了可视化,本人在flake8上面安装了flake8-chart 0.1.5这一插件,
通过这一插件将flake8的分析结果转化为图形(只支持饼图和柱状图)。
执行以下命令:
flake8 --statistics shadowtest |flake8chart--chart-type=BAR --chart-output=shadow.svg
在Jenkins上分析flake8的报告
在Flake8上安装插件,flake8-junit-report将flake8的报告转换为junit format,可以通过构建后操作 Publish Junit testresult report能不能输出文档:
1.安装flake8-junit-report
2. pip install flake8-junit-report
3.输出Flake8测试报告
4.flake8 --output-file flake8.txt shadowtest
5.转换成junit测试结果的xml
6.python -m junit_conversor flake8.txt flake8_junit.xml
7.转换成junit.xml报告:
8.在Jenkins上面展示: