【Python】読みやすいテストの秘訣「Arrange-Act-Assert」パターンとは？

2025年10月15日

ユニットテストの価値は、バグを検出することだけではありません。優れたテストは、そのコードが「どのように振る舞うべきか」を示す生きたドキュメントとしても機能します。そして、テストがドキュメントとして機能するためには、何よりもまず**「読みやすい」**ことが不可欠です。

この読みやすさを実現するための、シンプルかつ世界標準の設計パターンが**「Arrange-Act-Assert（AAA）」（準備-実行-検証）**です。今回は、このAAAパターンとは何か、そしてなぜあなたのテストコードを劇的に改善するのかを解説します。

AAAパターンとは？

Arrange-Act-Assert（AAA）は、テストケースを以下の3つの明確なセクションに分割する構成パターンのことです。

Arrange (準備): テストを実行するための前提条件をすべて整えるセクションです。テスト対象のオブジェクトの作成、データベースへのテストデータの投入、外部APIのモック化、関数の入力値の準備などを行います。
Act (実行): テストしたい核心的な処理を、一行で実行するセクションです。テスト対象の関数やメソッドを呼び出すコードがこれにあたります。
Assert (検証): 実行の結果が期待通りであったかを確認するセクションです。assert文を用いて、関数の戻り値や、システムの状態変化（DBのレコード数など）が正しいことを検証します。

この3つのセクションを意識的に設けることで、テストの「物語」が明確になります。「このような準備をして（Arrange）、この操作を実行したら（Act）、こうなるはずだ（Assert）」というストーリーが、誰の目にも明らかになるのです。

構造化されていないテストの問題点

AAAパターンを適用しないと、テストコードはどうなるでしょうか。ユーザーがお気に入りの記事を登録するAPIのテストを例に見てみましょう。

構造化されていないテストの例:

import pytest
from accounts.models import User
from articles.models import Article, Favorite

@pytest.mark.django_db
def test_add_favorite_api(api_client):
    user = User.objects.create_user(username="testuser", password="password")
    article = Article.objects.create(title="Test Title", author=user)
    api_client.force_authenticate(user)
    assert Favorite.objects.count() == 0
    url = f"/api/articles/{article.id}/favorite/"
    response = api_client.post(url)
    assert response.status_code == 201
    assert Favorite.objects.count() == 1
    assert Favorite.objects.first().article == article
    assert Favorite.objects.first().user == user

このテストは機能的には正しいですが、準備のためのコードと検証のためのコードが混在しており、一見して「何を」「どのように」テストしているのかが分かりにくいです。

解決策：AAAパターンでテストを構造化する

同じテストを、AAAパターンに沿って空行とコメントで明確に分割してみましょう。

AAAパターンを適用した良い例:

import pytest
from accounts.models import User
from articles.models import Article, Favorite

@pytest.mark.django_db
def test_add_favorite_api(api_client):
    # 1. Arrange (準備)
    user = User.objects.create_user(username="testuser", password="password")
    article = Article.objects.create(title="Test Title", author=user)
    api_client.force_authenticate(user)
    url = f"/api/articles/{article.id}/favorite/"

    # 2. Act (実行)
    response = api_client.post(url)

    # 3. Assert (検証)
    assert response.status_code == 201
    assert Favorite.objects.count() == 1
    
    favorite_entry = Favorite.objects.first()
    assert favorite_entry.article == article
    assert favorite_entry.user == user

コードの内容は全く同じですが、構造が明確になったことで、可読性が劇的に向上しました。

Arrangeセクションを読めば、テストの前提条件がすぐにわかります。
Actセクションは一行だけであり、このテストがapi_client.post(url)という操作を検証したいのだという核心部分が明確です。
Assertセクションを読めば、この操作によって何が起きるべきか（ステータスコード201、Favoriteレコードが1件作られる、等）という期待結果がすぐに理解できます。