深入浅析Python代码规范性检测

时间:2021-05-22

一定要注重代码规范,按照平时的代码管理,可以将Python代码规范检测分为两种:

  • 静态本地检测:可以借助静态检查工具,比如:Flake8,Pylint等,调研了一下,用Flake8的相对较多,功能满足,本文将使用Flake8
  • git:可借助git hooks,本文推荐使用pre-commit。
  • 静态本地检测

    Flake8包装了Pyflakes、Pycodestyle和McCabe,也可以自定义插件。功能包括:

    • 检查代码是否符合PEP8
    • 检查是否包含语法错误和未使用的变量和导入
    • 检查代码的复杂度

    pip install flake8

    配置

    推荐在pycharm中配置flake8:

    参数说明:

    • Program中填写Flake可执行文件的具体路径
    • arguments中可添加自定义参数,比如设置每行的最大字符数,过滤某些文件(夹)等。

    安装完了之后单击就可以检测了:

    执行检测之后,如果出现 exit code 0 就说明代码规范,否则可按照提示进行整改。

    pre-commit

    官网: https://pre-commit.com/

    介绍:

    使用git的话,可以使用pre-commit钩子,在调用 git commit 命令时会自动执行脚本进行检测,若代码出错,则不会commit成功。

    作用:

    • 在git commit命令之前对代码进行规范性检测
    • 按照配置,对一些不符合规范的代码自动更新为规范的(比如:填充空格、更新import等)
    • 提示更新之后仍不符合规范的代码

    安装

    pip install pre-commit

    Linux中安装完成即可执行pre-commit命令,Windows中需将.exe的路径添加至环境变量,方可执行pre-commit命令。

    配置

    在项目根目录下添加.pre-commit-config.yaml文件。

    可参考官网样例,:

    repos:- repo: https://github.com/pre-commit/pre-commit-hooks rev: v2.3.0 hooks: - id: check-yaml - id: end-of-file-fixer - id: trailing-whitespace- repo: https://github.com/psf/black rev: 19.3b0 hooks: - id: black- repo: https://github.com/pre-commit/pre-commit-hooks rev: v2.3.0 hooks: - id: flake8 args: - --max-line-length=120

    具体的配置可结合官网或github中的说明文档进行相关配置更新。

    安装

    执行 pre-commit install 命令,会在.git/hook路径下生成pre-commit文件,这样就保证了pre-commit安装成功,可以正常使用了。

    然后执行:

    更新配置文件只需要执行 pre-commit install 即可。

    使用

    配置完成之后,在 git commit 之前都会执行刚才的配置,可根据执行的结果来更新或者提交代码。

    到此这篇关于Python代码规范性检测的文章就介绍到这了,更多相关Python代码规范性检测内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!

    声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

    相关文章