JDim テストガイド

JDimは Google Test を使って機能をテストします。テストはmakeコマンドでビルド、実行が行えます。

テストプログラムのビルドに必要なもの

JDimソースコードの各namespaceで生成されるオブジェクトファイル(*.o)や静的ライブラリ(*.a)
googletestのソースコード (セットアップを参照)

セットアップ

はじめにgoogletestのソースコードを用意します。 (a)ディストリビューションのソースパッケージをインストールするか、 (b)googletestリポジトリをクローンしてください。

(a) ディストリビューションのソースパッケージを利用する場合

ディストリのパッケージ管理ツールを使ってgoogletestのソースコードをインストールします。

Debian系

googletestをインストールします。
```
sudo apt install googletest
```
(b) googletestリポジトリを利用する場合

GitHubの"google/googletest"リポジトリからmasterブランチをクローンします。他のgoogletestリポジトリでも可能なはずです。
```
git clone -b master --depth 1 https://github.com/google/googletest.git /path/to/googletest
```
次にJDimをビルドします。configureスクリプトの引数 GTEST_SRCDIR にインストールしたソースディレクトリまたはクローンしたリポジトリのフルパスを指定してください。
```
autoreconf -i
./configure GTEST_SRCDIR=/usr/src/googletest
make
```
NOTE: GTEST_SRCDIR を指定しない場合は test/ ディレクトリ内の googletest がデフォルトのパスになります。

テストのビルドと実行

makeの test サブコマンドでテストコードのビルドと実行を行います。結果表示など詳細はGoogle Testを解説しているwebページを参照してください。

test/ でmake testするとテストコードのみビルドしてテスト実行
トップでmake testするとJDimとテストコードをビルドしてテスト実行

make test

テストを追加する

テストコードのファイル名は gtest_*.cpp の形式にする必要があります。ファイル名は小文字で gtest_サブディレクトリ名_ソースファイル名.cpp を推奨します。テストの記述方法はテストコードを見るかwebを参照してください。

例

src/jdlib/miscutil.cpp → test/gtest_jdlib_miscutil.cpp
src/core.cpp → test/gtest_core.cpp

制限

以下は今のところサポートしておりません。

JDim全体ではなくテスト対象のソースコードだけをビルドする
googletestのライブラリファイルやオブジェクトファイルを直接指定してテストプログラムをビルドする
src/main.cpp をテストする (ファイル名やエントリーポイントが衝突する)