CMake: CTEST_CUSTOM_TESTS_IGNOREを使ってテストを制御する方法

CMake 変数 CTEST_CUSTOM_TESTS_IGNORE の詳細解説

CTEST_CUSTOM_TESTS_IGNORE は、CMake の ctest_test() コマンドで実行されるテストを制御するための変数です。これは、特定のテストをテスト実行から除外したい場合に役立ちます。

構文

set(CTEST_CUSTOM_TESTS_IGNORE <REGULAR_EXPRESSION_LIST>)

説明

• <REGULAR_EXPRESSION_LIST> は、除外したいテストの名前を記述する正規表現のリストです。
• 複数の正規表現をスペースで区切って指定できます。
• テスト名は、テストファイル名とテスト名の組み合わせで構成されます。
• 正規表現は、Perl Compatible Regular Expressions (PCRE) の形式を使用する必要があります。

例

set(CTEST_CUSTOM_TESTS_IGNORE "MyTest1.cpp" "MyTest2.cpp::failingTest")

この例では、以下のテストが ctest_test() コマンドで実行されません。

• MyTest1.cpp ファイル内のすべてのテスト
• MyTest2.cpp ファイル内の failingTest テスト

CTESTCustom ファイルの使用

CTEST_CUSTOM_TESTS_IGNORE 変数は、CMakeLists.txt ファイルだけでなく、CTESTCustom ファイルでも設定できます。CTESTCustom ファイルは、テスト実行のカスタマイズに使用できる特別な CMake ファイルです。

CTESTCustom ファイルで CTEST_CUSTOM_TESTS_IGNORE 変数を設定するには、以下の形式を使用します。

set(CTEST_CUSTOM_TESTS_IGNORE "MyTest1.cpp" "MyTest2.cpp::failingTest")

注意事項

• CTEST_CUSTOM_TESTS_IGNORE 変数は、ctest_test() コマンドで実行されるテストのみを制御します。他のテスト実行コマンド (例: ctest) では影響を受けません。
• CTEST_CUSTOM_TESTS_IGNORE 変数は、テストが実行される前に設定する必要があります。テスト実行後に設定しても、効果はありません。

補足

CTEST_CUSTOM_TESTS_IGNORE 変数は、テスト実行から特定のテストを除外したい場合に役立ちます。テストを無効化したい場合は、ctest_test() コマンドの EXCLUDE_TESTS オプションを使用する方が効率的な場合があります。

EXCLUDE_TESTS オプションは、テスト名を直接指定する点が CTEST_CUSTOM_TESTS_IGNORE 変数と異なり、正規表現を使用する必要がないため、よりシンプルです。

CTEST_CUSTOM_TESTS_IGNORE 変数は、CMake の ctest_test() コマンドで実行されるテストを制御するための便利なツールです。テスト実行から特定のテストを除外したい場合は、この変数を活用することをおすすめします。

ヒント

• チュートリアルやドキュメントで分からないことがあれば、オンラインフォーラムやコミュニティで質問してみてください。
• サンプルコードを実際に試して、自分の理解を深めましょう。
• 積極的にコードを書いて、スキルを磨きましょう。

ご参考になれば幸いです。

If you are looking for other ways to do something, here are some possible questions you could ask:

• How else can I achieve [goal]?
• What are other approaches to [problem]?
• Are there any alternative solutions to [issue]?
• What are other methods for [task]?
• What are different ways to do [activity]?

If you are looking for other information, here are some possible questions you could ask:

• What are other resources on [topic]?
• Are there any other perspectives on [issue]?
• What are other examples of [concept]?
• Are there any other related topics to [subject]?
• What are other ways to learn about [topic]?

Please let me know if this is helpful or if you have any other questions.