5.3.8 TestLoader オブジェクト

TestLoaderクラスは、クラスやモジュールからテストスイートを作成するために使用します。通常はこのクラスのインスタンスを作成する必要はなく、 unittestモジュールのモジュール属性defaultTestLoaderを共用インスタンスとして使用することができます。

TestLoader オブジェクトには以下のメソッドがあります:

loadTestsFromTestCase( testCaseClass): TestCaseの派生クラスtestCaseClassに含まれる全テストケースのスイートを返します。

loadTestsFromModule( module): 指定したモジュールに含まれる全テストケースのスイートを返します。このメソッドはmodule内のTestCase派生クラスを検索し、見つかったクラスのテストメソッドごとにクラスのインスタンスを作成します。
警告: Testcaseクラスを基底クラスとしてクラス階層を構築するとfixtureや補助的な関数をうまく共用することができますが、基底クラスに直接インスタンス化できないテストメソッドがあると、この loadTestsFromModuleを使うことができません。この場合でも、 fixtureが全て別々で定義がサブクラスにある場合は使用することができます。

loadTestsFromName( name[, module])

文字列で指定される全テストケースを含むスイートを返します。

nameには``ドット修飾名''でモジュールかテストケースクラス、または TestCaseかTestSuiteのインスタンスを返す呼び出し可能オブジェクトを指定します。例えばSampleTestsモジュールに TestCaseから派生したSampleTestCaseクラスがあり、 SampleTestCaseにはテストメソッドtest_one()・ test_two()・test_three()があるとします。この場合、 nameに'SampleTests.SampleTestCase'と指定すると、 SampleTestCaseの三つのテストメソッドを実行するテストスイートが作成されます。'SampleTests.SampleTestCase.test_two'と指定すれば、test_two()だけを実行するテストスイートが作成されます。インポートされていないモジュールやパッケージ名を含んだ名前を指定した場合は自動的にインポートされます。

また、moduleを指定した場合、module内のnameを取得します。

loadTestsFromNames( names[, module]): loadTestsFromName()と同じですが、名前を一つだけ指定するのではなく、複数の名前のシーケンスを指定する事ができます。戻り値は names中の名前で指定されるテスト全てを含むテストスイートです。

getTestCaseNames( testCaseClass): testCaseClass中の全てのメソッド名を含むソート済みシーケンスを返します。

以下の属性は、サブクラス化またはインスタンスの属性値を変更してTestLoaderをカスタマイズする場合に使用します。

testMethodPrefix: テストメソッドの名前と判断されるメソッド名の接頭語を示す文字列。デフォルト値は'test'です。

sortTestMethodsUsing: getTestCaseNames()でメソッド名をソートする際に使用する比較関数。デフォルト値は組み込み関数cmp()です。Noneを指定するとソートを行いません。

suiteClass: テストのリストからテストスイートを構築する呼び出し可能オブジェクト。メソッドを持つ必要はありません。デフォルト値はTestSuiteです。

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