2022.11.20
Pythonでcommit時にlintのチェックをする
JavaScriptにESLintやPrettierがあるように、PythonはFlake8とautopep8というlinterとformatterがあります<br> 今回はこちらを設定していき、commit時にlintのチェックを走らせようと思います
linter・formatterとは
混同されがちなlinterとformatterですが、役割が違います<br>
linterはコードがベストプラクティスに沿っているかどうかをチェックするツールで、例えばPythonならbooleanは ==
ではなく is
で比較するなどをチェックしてくれます<br>
formatterはコードのスタイルをチェックするツールで、例えばスペースの数, 改行の位置, コメントの書き方などをチェックしてくれます<br>
このように役割は違いますが、どちらも目的は同じで、統一的な書き方をすることで品質向上, レビューコストの削減をすることが目的です
Pythonのlinterとformatter
今回はFlake8というlinterと、autopep8というformatterを使います<br> PythonにはPEP8という標準のコーディング規約があります。チーム開発するときにもよく基準にされている気がします<br> Flake8とautopep8はこのPEP8に準拠してコードのチェックを行います
作業していく
LinterとFormatterの設定
LinterとFormatterを入れます。パッケージ管理にはpoetryを使います
$ poetry add flake8 -D
$ poetry add autopep8 -D
もし必要があればエディタでlinterとformatterの設定をしてください<br> これでPEP8に沿っていない書き方をしたらエディタが怒ってくれるようになります
commit時にチェックする
ここまで設定するとエディタは怒ってくれますが、怒られを無視することもできてしまいます<br> そこで、Gitのcommit時にlintとformatを走らせ、整形されたコードのみpushできるようにします。<br> Pythonにはpre-commitというGitのpre-commitフックスクリプトを管理・メンテナンスするためのツールがあります。今回はこちらを使っていきます<br> こちらも普通にpoetryでinstallできます
$ poetry add pre-commit -D
インストールできたらpre-commitの設定ファイルを作成します。次のコマンドでファイルを作成します
$ poetry run pre-commit sample-config > .pre-commit-config.yaml
設定ファイルの中身を書いていきます<br> autopep8とflake8のhookがあるためこちらを指定します
// .pre-commit-config.yaml
# See https://pre-commit.com for more information
# See https://pre-commit.com/hooks.html for more hooks
repos:
- repo: https://github.com/pre-commit/mirrors-autopep8
rev: v1.5.7
hooks:
- id: autopep8
- repo: https://github.com/pycqa/flake8
rev: 3.9.2
hooks:
- id: flake8
設定ファイルができたら最後にinstallを実行します
$ pre-commit install
これで試しになにかをcommitしてみると、
autopep8.................................................................Passed
flake8...................................................................Failed
- hook id: flake8
- exit code: 1
というようにちゃんと怒ってくれました
さいごに
新しいPythonプロジェクトをはじめるたびに行う設定なのでまとめてみました<br> これで安心してチーム開発ができるようになります!