2012年3月11日日曜日

Visual Studio 11 Beta で Google Test を使う

Visual Studio 11 Beta が公開されましたね。
そこで Visual Studio 11 Beta でも Google Test を使ってみようと思います。

今回の元ネタは、Google グループの Google C++ Testing Framework のこちらの投稿です。
備忘録としてブログにまとめておこうと思います。

プロジェクトの準備
まずは、ダウンロードページより取得した Google Test を解凍します。
解凍したフォルダの中に msvc フォルダがあり、そこの gtest.sln を Visual Studio 11 で開きます。
(Visual Studio 11 Beta のインストールは済ませておいてください。)

プロジェクトのアップグレード(変換)ダイアログが出るので、
アップグレードします。
プロジェクトが正常に読み込まれたら、準備完了です。

ビルド
F7 キーを押して終わり。とはいきません・・・
error C2977: 'std::tuple' : テンプレート 引数の数が多すぎます
error C3203: 'tuple' : 非特殊クラス テンプレート は、テンプレート 引数として テンプレート パラメーター 'T' に使用できません。実際の型を指定してください
とか
error C2955: 'testing::internal::ParamIteratorInterface' : クラス テンプレート を使用するには テンプレート 引数リストが必要です
というエラーがでます。

一番簡単な対処方法は GTEST_HAS_TR1_TUPLE=0 としてしまうことです。
ただし、こうすると値をパラメータ化したテストで Combine が使えなくなってしまいます。

gtest-port.h
Combine を使えるようにするために、gtest/internal/gtest-port.h を編集します。
まずは、MSVC11 の <tuple> は名前空間が異なっているため、対応します。
gtest-port.h の 506 行目に以下を付け足します。
#  if defined(_MSC_VER) && _MSC_VER >= 1700
namespace std { namespace tr1 { using std::tuple; } }
#  endif

次に、Variadic Templates の上限を増やします。
えっ、と思う方もいるかもしれませんが、そういうもんだと思ってください。

gtest-port.h の 38 行目あたりに以下を付け足します。
#if defined(_MSC_VER) && _MSC_VER == 1700
#  ifndef _VARIADIC_MAX
#    define _VARIADIC_MAX 10
#  elif _VARIADIC_MAX < 9
#    define GTEST_HAS_TR1_TUPLE 0
#  endif
#endif
インクルード順の関係で、_VARIADIC_MAX がすでに定義されていたら、残念ながら使えないようにしています。

もし、確実に使いたい場合は
プロジェクトのプロパティからプリプロセッサの定義に _VARIADIC_MAX=10 を追加してください。

以上の対処でビルドエラーは解消されたはずです。
あとは今まで通りに使えると思います。

今回はここまでです。それでは。

2012年3月7日水曜日

NaCl で iutest を使ってみた

iutest を Google Native Client(以下、NaCl) で使用してみました。

ちょっと本題に入る前に iutest 自体のことを。
iutest 現在 v0.21.0.0 です。
今見返してみるとバグ修正が多いですね。。。テストフレームワーク自体がバグっていてはダメですよね。。。
バグ修正以外だと、NaCl の対応を強化したり、C++11 の機能を使ってみたりしました。
それと、WARN flavor で紹介した INFORM マクロですね。


さて、本題です。
公開の仕方があっているのかわかりませんが、サンプルを用意しました。
NaCl サンプル
このサンプルも動作が怪しいですが…

ただ、NaCl でも使えることを確認しただけです。
NaCl での printf 出力が上手くできなくて、出力をメッセージに流すようにしています。

今回は、これだけです。ご意見など頂けたら嬉しいです。
それでは。

2012年3月2日金曜日

Google Test を使ってみる - その5(関数内の失敗)

まずは、下記のコードをご覧下さい。
void SubTest(int** pp)
{
    *pp = NULL;
    ASSERT_TRUE( NULL != *pp );
}

TEST(Sample, Test)
{
    int* p=NULL;

    SubTest(&p);

    ASSERT_TRUE( NULL != p );
}
さて、このテストは失敗します。失敗しますが、あなたはどのような結果を望みますか?

[----------] 1 test from Sample
[ RUN      ] Sample.Test
main.cpp(4): error: Value of: NULL != *pp
  Actual: false
Expected: true
main.cpp(11): error: Value of: NULL != p
  Actual: false
Expected: true
[  FAILED  ] Sample.Test (1 ms)
[----------] 1 test from Sample (2 ms total)

実際に実行してみると、このような結果になります。
期待通りでしたか?


期待通り?いや、期待通りではない?ですよね??
そうなんです。
SubTest 関数で ASSERT_TRUE が失敗しても Test は続行されてしまうのです。
実は、ASSERT_* マクロはテストを中断するために return するだけなのです。

では、どのようにしてテストを中断したらよいのでしょう。

例外を使う
幸いなことに Google Test には例外を使うオプションが用意されています。
--gtest_throw_on_failure を使うと、失敗時に例外を投げるようになります。

結果がこちら。
[ RUN      ] Sample.Test
main.cpp(7): error: Value of: NULL != *pp
  Actual: false
Expected: true
続行するには何かキーを押してください . . .

テストが中断するようになりました。が、テスト全体が中断するようになってしまいました。
これは、意図している結果と少し違います。

ここでは、SubTest で失敗が発生したら Sample.Test のみを中断させたいのです。

ASSERT_NO_FATAL_FAILURE を使う
ASSERT_NO_FATAL_FAILURE という、このためだけにあると言っても過言ではないマクロがあります。
ASSERT_NO_FATAL_FAILURE(statement) マクロでは、 statement で失敗が発生した場合に失敗します。

では、早速組み込んでみましょう。

TEST(Sample, Test)
{
    int* p=NULL;

    ASSERT_NO_FATAL_FAILURE( SubTest(&p) );

    ASSERT_TRUE( NULL != p );
}

SubTest の呼び出しを、ASSERT_NO_FATAL_FAILURE で囲うだけです。
続いて、出力結果です。

[----------] 1 test from Sample
[ RUN      ] Sample.Test
main.cpp(4): error: Value of: NULL != *pp
  Actual: false
Expected: true
main.cpp(11): error: Expected: SubTest(&p) doesn't generate new fatal failures in the current thread.
  Actual: it does.
[  FAILED  ] Sample.Test (16 ms)
[----------] 1 test from Sample (16 ms total)

期待通り、SubTest 内部で発生した失敗を検知し Sample.Test が中断するようになりました!
これで、テストの記述の仕方の幅が広がりましたね!

今回はここまで。

※ Google Test 関係の記事一覧はこちら