📝

GoogleTestの書き方(初心者向け)

2020/09/27 に公開

※この記事は、Qiitaに投稿した記事を一部変更したものです。
<a href="https://qiita.com/kunosu/items/0f0f063fff189482a97e" style="" target="_blank" rel="nofollow noopener noreferrer">https://qiita.com/kunosu/items/0f0f063fff189482a97e</a> <a class="header-anchor-link" href="#%E3%81%93%E3%82%93%E3%81%AA%E4%BA%BA%E5%90%91%E3%81%91" aria-hidden="true"/> こんな人向け</h1> <li>仕事でGoogleTest/GoogleMockを使うことになったが使ったことがない</li> <li>GoogleTest自体の導入はすでに済んでいる</li> <li>テスト対象はC言語で書かれている</li> <a class="header-anchor-link" href="#%E3%83%86%E3%82%B9%E3%83%88%E3%82%B3%E3%83%BC%E3%83%89%E3%81%AE%E5%85%A8%E4%BD%93%E5%83%8F" aria-hidden="true"/> テストコードの全体像</h1> GoogleTestはC++で動く。 Cで実装したコードはCの部分を「<code>extern "C"</code>」で囲めば試験可能。 全体はこんな感じ <li>インクルード <li>試験対象が動くのに必要なヘッダファイルもインクルード</li> <li>モッククラスの宣言</li> <li>テストフィクスチャクラス</li> <li>テストケース1</li> <li>テストケース2</li> <li>テストケースn</li> 今回は以下の関数に対するテストコードを例にする。 <div class="code-block-container"><pre class="language-c"><code class="language-c">int func(int a, b) { if (0 &lt; sub_func(a)) { return a + b; } else { return a - b; </code></pre></div>ここで、サブ関数<code>sub_func()</code>はまだ未作成。 ただし、I/Oは決まっている。 <div class="code-block-container"><pre class="language-c"><code class="language-c">// プロトタイプ宣言 int sub_func(int a); </code></pre></div>また、組込みだと開発対象の機械専用の関数(メーカーが独自に用意した関数など)もある。 <a class="header-anchor-link" href="#%E3%83%A2%E3%83%83%E3%82%AF%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%A3%E8%A8%80" aria-hidden="true"/> モッククラスの宣言</h1> まずはサブ関数の代わりに動くモックを作成。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">// モッククラスの宣言 class TestMock { public: // MOCK_METHODn(関数名, 戻り値の型(引数1, 引数2, ...)) // nは引数の数 MOCK_METHOD1(sub_func, int(int a)); } *testMock; // モック化したい関数を書く int sub_func(int a) { return testMock-&gt;sub_func(a); <a class="header-anchor-link" href="#%E3%83%86%E3%82%B9%E3%83%88%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%83%81%E3%83%A3%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%AE%E5%AE%9A%E7%BE%A9" aria-hidden="true"/> テストフィクスチャクラスの定義</h1> ここでは試験で使うクラス、及び共有リソース(配列など)の定義、初期化を行う。 <li>テストフィクスチャ <li>テストを実行させるために必要な状態や前提条件</li> <li>参考 : <a href="https://www.weblio.jp/content/%E3%83%86%E3%82%B9%E3%83%88%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%83%81%E3%83%A3" target="_blank" rel="nofollow noopener noreferrer">https://www.weblio.jp/content/テストフィクスチャ</a> <li>fixture(フィクスチャ) : 備品</li> 毎回動作が決まっているモックもここで動作を定義する。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">// テストフィクスチャクラスの定義 class FuncTest : public Test { protected: // 試験開始時に一回だけ実行 static void SetUpTestCase() { // 試験終了時に一回だけ実行 static void TearDownTestCase() { // 各テストケース実行前に実行 virtual void SetUp() { testMock = new TestMock(); // 各テストケース実行後に実行 virtual void SetUp() { delete testMock; // 試験対象の引数などを宣言 int a; int b; int ans; <a class="header-anchor-link" href="#%E3%83%86%E3%82%B9%E3%83%88%E3%82%B1%E3%83%BC%E3%82%B9" aria-hidden="true"/> テストケース</h1> ここで一つ一つのテストケースを記述。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">// 使うGoogleMockの名前をインポート using ::testing::Return; using ::testing::_; // TEST_F(テストフィクスチャクラス名, テストケース名) TEST_F(FuncTest, sample1) { // パラメータを設定 a = 1; b = 2; // sub_func呼び出し時、常に0を返すように設定 EXPECT_CALL(*testMock, sub_func(_)).WillRepeatedly(Return(0)); // 試験対象呼び出し ans = func(a, b); // 戻り値が期待するものか確認 EXPECT_EQ(3, ans); <a class="header-anchor-link" href="#%E3%83%A2%E3%83%83%E3%82%AF%E3%81%AE%E5%8B%95%E4%BD%9C%E3%82%92%E6%8C%87%E5%AE%9A" aria-hidden="true"/> モックの動作を指定</h2> <code>EXPECT_CALL()</code> で指定する。 引数は2つで、1つ目がモックを作成したときのモッククラス、2つ目で実際に呼び出される関数名とその引数を指定する。 例のように "_" にすると任意の値になる。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">EXPECT_CALL(*testMock, sub_func(_)).WillRepeatedly(Return(0)); </code></pre></div>戻り値は <code>WillRepeatedly(Return(...))</code> の <code>Return()</code> の引数として記載。 <a class="header-anchor-link" href="#%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E5%9B%9E%E6%95%B0%E3%81%AE%E6%8C%87%E5%AE%9A" aria-hidden="true"/> 呼び出し回数の指定</h3> 引数、戻り値の指定だけでなく、<code>.Time(1)</code> を追加して呼び出し回数も設定可能。 「この関数は呼び出されないことを試験したい」場合は呼び出し回数0にすればOK。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">// 3回呼び出されることを期待 EXPECT_CALL(*testMock, sub_func(_)).Times(3).WillRepeatedly(Return(0)); <a class="header-anchor-link" href="#%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%95%E3%82%8C%E3%82%8B%E3%81%9F%E3%81%B3%E3%81%AB%E7%95%B0%E3%81%AA%E3%82%8B%E5%80%A4%E3%82%92%E8%BF%94%E3%81%99" aria-hidden="true"/> 呼び出されるたびに異なる値を返す</h3> <code>WillRepeatedly(Return(x))</code>: 呼び出されるたびに <code>x</code> を返す</li> <code>WillOnce(Return(x))</code> :1回だけ <code>x</code> を返す</li> <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">// 1回目は0、2回目は1、3回目は2を返す EXPECT_CALL(*testMock, sub_func(_)) .WillOnce(Return(0)).WillOnce(Return(1)).WillOnce(Return(2)); <a class="header-anchor-link" href="#%E3%82%B9%E3%82%BF%E3%83%96%E3%82%92%E5%8B%95%E3%81%8B%E3%81%99" aria-hidden="true"/> スタブを動かす</h3> 同じテストコード内にスタブを作成。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">int stb_sub_func(int a) { // テストで動かすのに十分な処理を記載(引数チェックとか) </code></pre></div><code>Invoke</code> でスタブを指定するとサブ関数呼び出し時にスタブを代わりに実行。 <div class="code-block-container"><pre class="language-cpp"><code class="language-cpp">// stb_sub_func()を実行 EXPECT_CALL(*testMock, sub_func(_)).WillRepeatedly(Invoke(stb_sub_func)); <a class="header-anchor-link" href="#%E6%88%BB%E3%82%8A%E5%80%A4%E3%81%AA%E3%81%A9%E3%82%92%E6%AF%94%E8%BC%83" aria-hidden="true"/> 戻り値などを比較</h2> アサーションを使用。 <th style="text-align:left">成功条件(<code>flg</code> の値)</th>