33.4. TAPテスト #

様々なテスト、特にsrc/bin以下のクライアントプログラムテストはPerl TAPツールを使い、Perlテストプログラムproveを使って実行されます。 make変数PROVE_FLAGSを設定することでproveコマンドラインオプションを渡すことができます。 例えば、

make -C src/bin check PROVE_FLAGS='--timer'

詳細な情報はproveのマニュアルページを参照してください。

デフォルトのt/*.plに替えて、テストの指定サブセットを実行するために、make変数PROVE_TESTSを使用できます。proveを起動するMakefileからの相対パスの空白区切りのリストを指定します。 以下に例を示します。

make check PROVE_TESTS='t/001_test1.pl t/003_test3.pl'

《マッチ度[77.388535]》TAPテストはPerlモジュールIPC::Runが必要です。 このモジュールはCPANもしくはオペレーティングシステムのパッケージから入手可能です。 また、PostgreSQL--enable-tap-testsを有効にして構成しておく必要があります。 《機械翻訳》TAPテストには、PerlモジュールIPC::Runが必要です。 このモジュールは、CPANから、またはオペレーティングシステムのパッケージから入手できます。 また、PostgreSQLをオプション-enable-tap-testsで構成する必要があります。

一般的に言って、TAPテストは、make installcheckとした場合には以前インストールしたインストレーションツリーの実行ファイルをテストし、make checkとした場合には現在のソースから新しいインストレーションツリーを構築します。 どちらの場合も、ローカルインスタンス(データディレクトリ)を初期化し、その中で一時的にサーバを実行します。 テストの中には2つ以上のサーバを実行するものがあります。 従って、このテストはかなりリソース集約的になる可能性があります。

make installcheckとした場合でも、TAPテストはテストサーバを開始することを理解しておくことは重要です。 これは伝統的な非TAPテスト基盤とは異なります。非TAPテスト基盤ではその場合、既に動作しているテストサーバを使うことが期待されます。 PostgreSQLのサブディレクトリには、伝統的な形式のテストとTAP形式のものの両方を含むものがありますので、make installcheckは一時的なサーバと既に動作しているテストサーバからの結果を寄せ集めることになります。

33.4.1. Environment Variables #

《機械翻訳》データディレクトリは、テストファイル名に従って命名され、テストが失敗した場合は保持されます。 環境変数 PG_TEST_NOCLEANが設定されている場合、テストステータスに関係なく、データディレクトリは保持されます。 たとえば、pg_dumpテストを実行するときに、テスト結果に関係なくデータディレクトリを保持するには、次のようにします。

PG_TEST_NOCLEAN=1 make -C src/bin/pg_dump check

《機械翻訳》この環境変数は、テストの一時ディレクトリが削除されないようにもします。

《機械翻訳》テストスイートの多くの操作では、180秒のタイムアウトが使用されます。これは、低速なホストでは、ロードによって誘発されるタイムアウトになる可能性があります。 環境変数 PG_TEST_TIMEOUT_DEFAULTをより大きな数値に設定すると、この問題を回避するためにデフォルトが変更されます。