5.3.4 クラスと関数

クラス TestCase( ): TestCaseクラスのインスタンスは、テストの最小実行単位を示します。このクラスをベースクラスとして使用し、必要なテストを具象サブクラスに実装します。TestCaseクラスでは、テストランナーがテストを実行するためのインターフェースと、各種のチェックやテスト失敗をレポートするためのメソッドを実装しています。

クラス FunctionTestCase( testFunc[, setUp[, tearDown[, description]]]): このクラスではTestCaseインターフェースの内、テストランナーがテストを実行するためのインターフェースだけを実装しており、テスト結果のチェックやレポートに関するメソッドは実装していません。既存のテストコードをunittestによるテストフレームワークに組み込むために使用します。

クラス TestSuite( [tests]): このクラスは、個々のテストケースやテストスイートの集約を示します。通常のテストケースと同じようにテストランナーで実行すると、テストスイート内の全てのテストケースとテストスイートを実行します。テストケース・テストスイートを追加するためのメソッドを用意しています。testsには、スイートに追加するテストのシーケンスを指定する事ができます。

クラス TestLoader( ): モジュールまたはTestCaseクラスから、指定した条件に従ってテストをロードし、TestSuiteにラップして返します。モジュールからテストをロードする場合、全てのTestCase派生クラスを抽出し、名前が "test"で始まる全てのメソッドのインスタンスを作成します。

defaultTestLoader: TestLoaderのインスタンスで、共用する事ができます。 TestLoaderをカスタマイズする必要がなければ、新しい TestLoaderオブジェクトを作らずにこのインスタンスを使用します。

クラス TextTestRunner( [stream[, descriptions[, verbosity]]]): 実行結果を標準結果に出力する、単純なテストランナー。いくつかの設定項目がありますが、非常に単純です。グラフィカルなテスト実行アプリケーションでは、独自のテストランナーを作成してください。

main( [module[, defaultTest[, argv[, testRunner[, testRunner]]]]])

テストを実行するためのコマンドラインプログラム。この関数を使えば、次のように簡単に実行可能なテストモジュールを作成する事ができます。

if __name__ == '__main__':
    unittest.main()

場合によっては、doctest モジュールを使って書かれた既存のテストがあります。その場合、モジュールは既存のテストコードから unittest.TestSuite インスタンスを自動的に構築できる DocTestSuite クラスを提供します。バージョン 2.3 で新たに追加された仕様です。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。