【Python】unittestとmockの使い方を解説！

記事の文字数：2022

Pythonでのソフトウェア開発において、単体テスト（unittest）は品質を確保するために不可欠な要素です。本記事では、Python標準ライブラリのunittestを使ったテストの基本から、unittest.mockを活用して外部依存を排除する方法まで、実践的な実装方法を解説します。

2025/3/11 2025/3/19更新

Pythonには、標準ライブラリとしてunittestというテストフレームワークが用意されています。また、unittest.mockモジュールを使うことで、外部依存を排除した単体テストが容易に作成できます。本記事では、unittestとmockの基本的な使い方や単体テストコードの実行方法を解説します。

1. unittestの基本

unittestはPythonの標準テストフレームワークであり、テストケースの作成、実行、アサーションをサポートしています。

テストケースの作成方法

テストコードは以下のtest_add(self)のようにtest_から始まる関数名で作成します。

1
import unittest
2

3
# テスト対象の関数
4
def add(a, b):
5
    return a + b
6

7
class TestMathOperations(unittest.TestCase):
8
    def test_add(self):
9
        self.assertEqual(add(2, 3), 5)
10
        self.assertEqual(add(-1, 1), 0)
11
        self.assertEqual(add(0, 0), 0)
12

13
if __name__ == "__main__":
14
    unittest.main()

assertEqualでaddの結果と期待値が同一であることを確認しています。

テストケースの実行方法

作成したテストコードを実行するには、以下のコマンドを使用します。

1
python -m unittest -v unittest-ex01

実行結果は、以下のように表示されます。

1
test_add (test.TestMathOperations.test_add) ... ok
2

3
----------------------------------------------------------------------
4
Ran 1 test in 0.002s
5

6
OK

特定のクラス・メソッドを実行

特定のテストクラスやテストメソッドを実行したい場合は、以下のように指定します。

1
python -m unittest -v unittest-ex01.TestMathOperations
2
python -m unittest -v unittest-ex01.TestMathOperations.test_add

2. unittest.mockの使い方

unittest.mockを使うと、関数やクラスをモック（偽物のオブジェクト）に置き換えてテストを実施できます。 mock.patch は、特定のモジュールやクラスのメソッドを一時的にモックに置き換えるためのデコレーターまたはコンテキストマネージャーです。

モックには例えば以下のような設定が可能です。

return_value: モックが呼ばれた際に返す値を指定
side_effect: 呼び出しごとに異なる動作を指定（関数を渡すことも可能）

外部APIの呼び出しをモックする

以下に実装例を示します。

1
from unittest import TestCase
2
from unittest.mock import patch
3
import requests
4

5
# テスト対象の関数
6
def fetch_data(url):
7
    response = requests.get(url)
8
    return response.json()
9

10
class TestFetchData(TestCase):
11
    @patch("requests.get")
12
    def test_fetch_data(self, mock_get):
13
        mock_get.return_value.json.return_value = {"message": "Hello, world!"}
14
        result = fetch_data("http://example.com")
15
        self.assertEqual(result, {"message": "Hello, world!"})

@patchでrequests.getをモック化し、戻り値(return_value)に{"message": "Hello, world!"}を指定しています。
※実行にはrequestsモジュールが必要です。

デコレーターとしての使用

以下のように@patch.objectを指定し、デコレーター内にreturn_valueを指定することも可能です。

1
import unittest
2
from unittest.mock import patch
3

4
class MyClass:
5
    def method(self):
6
        return "real value"
7

8
class TestMyClass(unittest.TestCase):
9
    @patch.object(MyClass, "method", return_value="mocked value")
10
    def test_method(self, mock_method):
11
        obj = MyClass()
12
        self.assertEqual(obj.method(), "mocked value")
13

14
if __name__ == "__main__":
15
    unittest.main()

@patch.objectデコレーター内でMyClassのmethodの戻り値をmocked valueに指定し、assertEqualでmocked valueの期待値比較を行います。

コンテキストマネージャーとしての使用

withブロックでmockを指定することもできます。以下に実装例を示します。

1
import unittest
2
from unittest.mock import patch
3
import requests
4

5
class TestMyClass(unittest.TestCase):
6
    def test_method(self):
7
        with patch("requests.get") as mock_get:
8
            mock_get.return_value.json.return_value = {"status": "ok"}
9
            response = requests.get("http://example.com")
10
            assert response.json() == {"status": "ok"}
11

12
if __name__ == "__main__":
13
    unittest.main()

requests.getの戻り値のjsonの戻り値に{"status": "ok"}を指定、assertで取得した値を比較するテストコードです。

クラスのフィールドをモックする

クラスのインスタンス変数（フィールド）をモックすることで、特定の状態をシミュレートできます。

1
import unittest
2
from unittest.mock import patch
3

4
class Config:
5
    def __init__(self):
6
        self.api_key = "real_api_key"
7

8
class Service:
9
    def __init__(self, config):
10
        self.config = config
11

12
    def get_api_key(self):
13
        return self.config.api_key
14

15
class TestService(unittest.TestCase):
16
    def test_get_api_key(self):
17
        config = Config()
18
        with patch.object(config, "api_key", new="mocked_api_key"):  # インスタンス変数をモック化
19
            service = Service(config)
20
            self.assertEqual(service.get_api_key(), "mocked_api_key")
21

22
if __name__ == "__main__":
23
    unittest.main()

上記patch.objectでConfingクラスのapi_keyをmocked_api_keyでモック化しています。

呼び出しごとに異なる値を返す

side_effectを利用すると呼び出しごとに異なる結果を出力することができます。

1
from unittest import TestCase
2
from unittest.mock import patch
3

4
def fetch_data():
5
    import requests
6
    response = requests.get("http://example.com")
7
    return response.json()
8

9
class TestFetchData(TestCase):
10
    @patch("requests.get")
11
    def test_fetch_data_multiple_values(self, mock_get):
12
        mock_get.return_value.json.side_effect = [
13
            {"status": "ok"},
14
            {"status": "error"}
15
        ]
16

17
        self.assertEqual(fetch_data(), {"status": "ok"})    # 1回目の呼び出し
18
        self.assertEqual(fetch_data(), {"status": "error"})  # 2回目の呼び出し

上記例ではfetch_data()を1回目と2回目で異なるレスポンスを返す挙動になります。

例外を発生させる

side_effectを利用することで、特定の例外を発生させることもできます。

1
from unittest import TestCase
2
from unittest.mock import patch
3

4
def fetch_data():
5
    import requests
6
    response = requests.get("http://example.com")
7
    return response.json()
8

9
class TestFetchData(TestCase):
10
    @patch("requests.get")
11
    def test_fetch_data_raises_exception(self, mock_get):
12
        mock_get.side_effect = Exception("Network error")
13

14
        with self.assertRaises(Exception) as context:
15
            fetch_data()
16

17
        self.assertEqual(str(context.exception), "Network error")

上記例ではfetch_dataの結果にNetwork errorを発生させています。

まとめ

unittestを使って基本的なテストケースを作成できる。
unittest.mockを利用すると、外部依存を排除したテストが可能になる。
patchを活用することで、特定の関数やメソッドをモックできる。
クラスのフィールドをpatch.objectでモックすることで、環境設定や状態を変更可能。
side_effectを利用すると、呼び出しごとに異なる値を返したり、例外を発生させることができて、より柔軟なテストが可能になる。
return_valueを利用すると、指定した固定値を返すことができる。

unittestとmockを活用して、効率的なテストを実装しましょう！

参考

unittest --- ユニットテストフレームワーク
 unittest.mock --- モックオブジェクトライブラリ

以上で本記事の解説を終わります。
よいITライフを！