Pythonで効率的にコードレビューを行う方法 - Python転職初心者向けエンジニアリングブログ

コードレビューって、ちょっと面倒だなと思ったことはありませんか？でも、良いコードレビューはチームのスキルを上げ、バグを減らし、品質の高いコードを生み出すために欠かせません。そこで、Pythonを使って効率的にコードレビューを行う方法を紹介します。コードレビューをもっと楽しく、そして効果的に行うためのツールやテクニックを学んでいきましょう！

自動フォーマットでレビューをスムーズに

まず、コードレビューの大敵と言えば「コードのフォーマット」です。インデントやスペースの違い、コーディングスタイルのばらつきなど、些細な違いが気になりますよね。でも、Pythonにはコードを自動で整えてくれるツールがあります。これを使えば、フォーマットの違いに時間を取られずに、コードの本質的な部分に集中できます。

Blackでコードを自動整形

Blackは、Pythonのコードを自動で整形してくれるツールです。Blackを使えば、インデントやスペースの問題は一瞬で解決します。

インストール方法は以下の通りです。

pip install black

そして、以下のコマンドでコードを整形します。

black your_script.py

これだけで、Pythonのコードが統一されたスタイルに整形されます。実際の使用例を見てみましょう。

# Before using Black
def greet( name ) :
    print( "Hello, " + name + "!" )

Blackを適用すると、次のように変わります。

# After using Black
def greet(name):
    print("Hello, " + name + "!")

実行結果

ファイルが自動でフォーマットされ、見やすくなりました！

これで、インデントやスペースの議論に時間を取られることなく、ロジックやアルゴリズムに集中してコードレビューができます。

flake8でコーディングミスをチェック

次に紹介するのは「flake8」という静的コード解析ツールです。flake8は、コードに潜むケアレスミスやスタイルガイドに違反している部分をチェックしてくれます。これを事前に実行しておけば、コードレビューで細かな指摘を減らせます。

flake8のインストールと使用方法

まずはインストールしましょう。

pip install flake8

次に、flake8でコードをチェックします。

flake8 your_script.py

例えば、以下のようなコードがあったとします。

def calculate_sum(a, b):
    sum = a + b
    return sum

このコードをflake8でチェックすると、次のような警告が表示されるかもしれません。

your_script.py:2:5: F841 local variable 'sum' is assigned to but never used

これは、sumという変数名がPythonの組み込み関数と重複していることを教えてくれています。このような指摘を事前に解決することで、レビューの質が上がります。

実行結果

コードの潜在的な問題点をflake8が指摘してくれました！

Pre-commitで自動チェックを設定

コードレビュー前に自動でコードをチェックする仕組みを作ると、さらに効率が上がります。これには「pre-commit」というツールが便利です。pre-commitを使えば、コードをコミットする前に自動でBlackやflake8を実行して、問題があればコミットを止めることができます。

Pre-commitのインストールと設定

以下のコマンドでpre-commitをインストールします。

pip install pre-commit

次に、プロジェクトのルートディレクトリに.pre-commit-config.yamlというファイルを作成し、以下の内容を追加します。

repos:
  - repo: https://github.com/psf/black
    rev: 23.7.0
    hooks:
      - id: black
  - repo: https://github.com/pycqa/flake8
    rev: 6.0.0
    hooks:
      - id: flake8

その後、以下のコマンドでpre-commitを設定します。

pre-commit install

これで、コードをコミットするたびに自動でBlackとflake8が実行され、問題があればコミットがブロックされます。

実行結果

コミット時に自動でコードチェックが実行されるようになりました！

これにより、コードレビューで指摘されるような基本的なミスを事前に防ぐことができ、レビューの効率が大幅にアップします。

GitHub Actionsでレビューを自動化

コードレビューをもっと効率化したいなら、GitHub Actionsを使って、自動でコードチェックを行う仕組みを作るのもおすすめです。GitHubにコードをプッシュするたびに、Blackやflake8を自動で実行してくれるので、手間が省けます。

GitHub Actionsの設定方法

.github/workflows/フォルダにpython-ci.ymlというファイルを作成し、以下の内容を追加します。

name: Python CI

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: '3.8'
      - name: Install dependencies
        run: |
          pip install black flake8
      - name: Run Black
        run: black --check .
      - name: Run flake8
        run: flake8 .

これで、GitHubにコードをプッシュすると自動的にコードのフォーマットとスタイルチェックが実行されるようになります。

実行結果

GitHub上で自動的にコードチェックが実行され、レビュー作業がさらに楽になります！

GitHub Actionsを使うことで、コードが自動でチェックされ、レビュー時に手間がかかる部分を減らすことができます。

まとめ

Pythonを使ったコードレビューの効率化には、Blackやflake8、pre-commit、そしてGitHub Actionsといったツールがとても役立ちます。これらのツールを使うことで、コードレビューにかかる時間を短縮し、レビューの質を上げることができます。レビューがスムーズになると、チーム全体の開発スピードも上がり、より良いプロジェクトが完成します。

次回のテーマ

次回は「Pythonでプロジェクト管理ツールを自作する方法」をご紹介します。お楽しみに！