CxxTest使用指南(入門篇)
準備工作:
1、 安裝perl/Python
2、 下載解壓CxxTest
3、 設置環境變量:
如果使用Perl,則設置一個名為PERL的環境變量,值為perl.exe的位置。(比如D:\Perl\Bin\Perl.exe);
如果安裝Python,則設置一個名為PYTHON的環境變量,值為你安裝的Python目錄下的python.exe路徑(比如D:\Python25\python.exe);
設置一個名為CXXTESTDIR 的環境變量,值為CxxTest解壓后的目錄。(比如D:\Cxxtest)。(設置CXXTESTDIR的原因:免去每次在makefile文件中指定CXXTESTDIR的目錄)
方式一:使用CxxTest \sample\msvc中的框架
1、 拷貝msvc文件夾到工程目錄中
打開CxxTest_Workspace.sln,可以看到三個項目:
- CxxTest_3_Generate 運行 cxxtestgen.pl 生成 runner.cpp 文件;
- CxxTest_2_Build 編譯生成的runner.cpp文件;
- CxxTest_1_Run 運行測試;
2、 修改其中的makefile文件:
1)將以下內容:
# Where to look for the tests
TESTS = ..\gui\*.h ..\*.h
修改為:
# Where to look for the tests
TESTS = *.h
這段話的作用是查找測試文件,我們的測試文件是.h格式的,放在當前目錄下。(如果是.hpp格式的話,自然改成*.hpp;放在其它目錄的話,還要修改路徑)
2)將以下內容刪除:
# Where the CxxTest distribution is unpacked
CXXTESTDIR = ..\..
因為先前已經定義了CXXTESTDIR的環境變量,這里的定義可以省掉。
3、 在CxxTest_3_Generate項目中添加測試文件
這是測試文件的一個簡單的例子:
// Sampletest.h
#include <cxxtest/TestSuite.h>
//定義一個測試套件類,將測試用例放入其中
class SampletestSuite : public CxxTest::TestSuite
{
public:
//定義測試,以test作為測試函數前綴,
//這是cxxtestgen.pl或cxxtestgen.py對測試文件進行掃描,抽取測試用例的依據
void testMultiplication( void )
{
TS_ASSERT_EQUALS( 2 * 2, 5 );
}
};
4、 運行測試,即生成CxxTest_1_Run,可在輸出窗口看到測試結果,并雙擊結果行可定位到源代碼。
方法二:簡化msvc,將Generate,Build,Run集成到一個項目中
1、 在工程中添加新項目:Unit_Test
將修改后的makefile文件拷貝到Unit_Test目錄中。
2、 在Unit_Test項目源文件中添加新建項dummy
無論添加進來的是.cpp,還是.h,將后綴名去掉。
右擊dummy,選擇屬性,在彈出的屬性頁中,“自定義生成步驟”選項->“命令行”選項,輸入:
ECHO Don't Delete this file!!! > Dummy
ECHO -
ECHO -
ECHO -------------------- Generating test cases --------------------
if exist runner.cpp del runner.cpp /Q
NMAKE runner.cpp /nologo
ECHO -
ECHO –
在“輸出”選項中輸入:
Runner.cpp
Dummy只是一個文件,里邊可以是任何內容,關鍵點在于對Dummy文件進行編譯的時候所執行的操作,這是一個批處理文件,這個批處理文件執行生成 testcase 的操作,也就是調用Python/Perl生成測試用例(也就是runner.cpp文件)。為了保持每次編譯都可以生成新的runner文件,就必須保證
1)Dummy文件在runner.cpp之前進行編譯;
2)Dummy文件每次都必須被重新編譯。
第一點是通過文件順序來的,第二點是在生成事件里邊重新生成Dummy文件來保證的(VS2005似乎沒問題,VC6似乎還是有些問題的)。
從另外一個角度講,這個Dummy文件相當于 samples/msvc 第一和第二個項目的功能。(即Generate和Build)
3、 編譯dummy文件,生成runner.cpp,將其添加到Unit_Test“源文件”中。
確定當前目錄中已有.h測試文件,否則可能提示錯誤。
4、 右擊Unit_Test,選擇屬性,在彈出來的屬性頁中, “生成事件”選項->“生成后事件”選項->“命令行”選項中輸入:
ECHO -
ECHO -
ECHO -------------------- Running Unit Test Cases --------------------
$(OutDir)\$(TargetName).exe
ECHO -
ECHO -
ECHO -------------------------------------------------------------------------------
DEL runner.cpp
放在項目“生成后事件”中的這一段命令,運行生成的測試,相當于samples/msvc 第三個項目的功能。(即Run)
5、 在Unit_Test“頭文件”中,添加新的.h測試文件。
生成Unit_Test,即可在輸出窗口分割線下看到運行測試的結果,雙擊結果行可以定位到源代碼。
如:
1>-------------------- Running Unit Test Cases --------------------
1>Running 1 test
1>In MathsTestSuite::testMultiplication:
1>f:\test\cxxunittest\cxxunittest\sampletest.h(9): Error: Expected (2 * 2 == 5), found (4 != 5)
1>Failed 1 of 1 test
1>Success rate: 0%
1>----------------------------------------------------------------------------------
方法三:抽取出一個Unit_Test文件夾
所謂方法三,不過是將方法二中的Unit_Test文件夾,替代方法一中的msvc文件夾,移動到其它的項目中使用而已。
不像方法一的msvc那樣需要三個項目,也不需像方法二那樣,每次都修改dummy,和項目屬性,添加命令行。將Unit_Test文件夾各個屬性都配置好之后,獨立出來隨時備用。
準備工作,如前所言。
要進行測試時:
將Unit_test文件夾拷貝放到工程目錄中,在工程中添加里面的Unit_Test項目,仿照Sampletest.h寫自己的測試文件。
運行測試時:
先編譯dummy,再生成該測試項目。(如果沒有另外添加*.h文件,直接生成就可以了)