unittestの実行方法

Python 2.7.3のunittestでテストを実行する方法。実行方法には2種類ある。

• コマンドラインインタフェース(CLI): テストモジュール名などを指定して実行
• テストディスカバリ: テストモジュール名のパターンを指定して実行

CLIは、特定のモジュールのデバッグに便利。ディスカバリはコミット前などの回帰テストに便利。

CLIでは次のように、モジュール名・クラス名・メソッド名のいずれかを修飾子込みで指定する。

$ python -m unittest test_library.test_module
$ python -m unittest test_library.test_module.TestClass
$ python -m unittest test_library.test_module.TestClass.test_method

空白区切りで複数のテストを指定することもできる。

$ python -m unittest test_library.test_module1 test_library.test_module2

テストディスカバリでは、サブコマンドdiscoverを使用する。下記コマンドで、project_top_directory以下の"test*.py"にマッチするテストファイルが実行される。

$ cd project_top_directory
$ python -m unittest discover

対象ディレクトリやテストファイル名のパターンを変更したい場合は、オプション-s, -p, -tを用いる。

• -s: テストモジュール検索開始ディレクトリ
• -p: テストファイル名のパターン
• -t: プロジェクトのトップディレクトリ

References

• 25.3. unittest — ユニットテストフレームワーク — Python 2.7ja1 documentation
• 25.3.2. コマンドラインインタフェース
• 25.3.3. テストディスカバリ