nDiki : CppUnit

CppUnit

C++ 用単体テストフレームワーク。組み込み用などのプログラムでも使えるように修正された CppUnit-x というのもある。

支援ツールとして河童がある。

また CppUnit 1.5 から派生した C++ 用単体テストフレームワークとして QtUnit がある。

以下 1.9.10 の頃の話。

Microsoft Visual C++ 6.0 で CppUnit を使った時のメモ

インストール (CppUnit 1.9.10)

適当なディレクトリで cppunit-1.9.10.tar.gz を展開する
ワークスペース cppunit-1.9.10/src/CppUnitLibraries.dsw を Visual C++ 6.0 で開く
[ビルド]->[バッチビルド...] メニューを選択。全てのプロジェクトを選択し、ビルド。
1. 依存関係とビルドの順番の問題で一度でビルドできない場合は何度か繰り返す
[ツール]->[カスタマイズ] メニューを選択。CppUnit Testrunner Developer Studio Add-in を [アドインおよびマクロファイル] に追加
- [参照]ボタンを押して、cppunit-1.9.10/lib/TestRunnerDSPlugIn.dllを追加する

スタティックリンクランタイムライブラリ用について

CppUnit のプロジェクト設定では、「使用するランタイムライブラリ」がDLLのもののみなので

マルチスレッド(デバッグ)

等が欲しい場合は、自分で設定を修正してビルドする必要がある(CppUnit 自身のスタティックリンク/ダイナミックリンクではなくランタイムライブラリの話)

テストプログラム作成環境の整備

Visual C++ 6.0 で [ツール]->[オプション] を選択。[ディレクトリ]/インクルードファイルに cppunit-1.9.10/include の絶対パスを指定
同ライブラリファイルに cppunit-1.9.10/lib の絶対パスを指定

test fixture を書く

こんな感じ。

 #include "cppunit/TestFixture.h"
 #include "cppunit/TestSuite.h"
 #include "cppunit/TestCaller.h"
 #include "cppunit/extensions/HelperMacros.h"

 class TestClassTest : public CppUnit::TestFixture {
   CPPUNIT_TEST_SUITE(TestClassTest);
   CPPUNIT_TEST(testAAA);
   CPPUNIT_TEST_SUITE_END();
 public:

   void testAAA() {
   }
 };

assertion を書く

cppunit/TestAssert.h で定義されている CPPUNIT_ASSERT マクロファミリを使うのが便利。

 CPPUNIT_ASSERT(condition)
 CPPUNIT_ASSERT_MESSAGE(message, condition)
 CPPUNIT_FAIL(message)
 CPPUNIT_ASSERT_EQUAL(expected, actual)
 CPPUNIT_ASSERT_EQUAL_MESSAGE(message, expected, actual)
 CPPUNIT_ASSERT_DOUBLES_EQUAL(expected, actual, delta)

http://cppunit.sourceforge.net/ の Modules -> Making assertions 参照。