1. 程式人生 > >C語言單元測試框架-Check

C語言單元測試框架-Check

     雖然在UNIX上用C語言做開發已經有一段時間了,但是我不得不承認,自己單元測試做的並不好。恰好最近有新的開發任務,就學習了一些關於測試驅動開發的知識,準備改進自己的單元測試。XP程式設計已經興起好一段時間了,也形成了很多優秀的單元測試框架,例如:JUnit,想必使用JAVA的朋友,對該測試框架已經很熟悉了。我記得《程式設計師》雜誌也有一期專門以TDD作為專題。其實,我真的好羨慕JAVA程式設計師^_^,他們總是有各種各樣的優秀的工具可以用。哎。。。,臨淵羨魚,不如退而結網。CppUnit是一個優秀的C++單元測試框架,因此,它應該也可以作為C語言的單元測試框架。但是,這裡我沒有選擇CppUnit,而是直接選擇了一個針對C語言的單元測試框架Check。對於C語言採用哪種單元測試框架比較好,我實在沒有這方面的經驗^_^。如果那位朋友對C語言單元測試方面有經驗,我真心的希望你能給予我幫助,這裡我先謝謝了^_^!就象我說的哪樣,因為我沒有很多測試先行這樣的經驗,所以這裡我只是介紹Check的基本使用方法,搭鍵單元測試環境的一個過程。Check相關知識是我今天上午才學的,晚上就總結一下寫了出來,我是典型的現學現賣^_^。

     我這裡介紹一下一個實現加法功能的程式(就是,給定2個數,該程式返回這兩個數的和,夠簡單吧^_^)單元測試過程。首先我建立了3個目錄:include、add、unit_test。在include目錄裡包含uni_test.h(該檔案作用下面我會介紹)、add.h、Check.h(該檔案是該測試框架原始碼中的一個頭檔案,在建立單元測試的過程中,需要包含該標頭檔案)。在unit_test.h和add.h填入一些最基本程式碼
uni_test.h
#ifndef _UNIT_TEST_H
#define _UNIT_TEST_H
#endif

#include "Check.h"

#ifdef __cplusplus
extern "C" {
#endif


#ifdef __cplusplus
}
#endif

#endif

      在上面程式碼中我們包含了Check.h標頭檔案。在add.h標頭檔案中,除了不包含該標頭檔案外,基本程式碼是類似的。

接著,我們在add目錄裡建立add.c檔案,並在其中#include "add.h"。

      在unit_test目錄中,我們建立test_add.c檔案(用來編寫測試用例的,並在其中包括Check.h)、test_main.c檔案(該檔案作用下面會介紹,這裡麵包含main函式)和libcheck.a(該靜態庫是編譯check框架原始碼生成的,在編譯測試用例的過程中需要連線該庫。

ok,萬事具備了,開始寫測試用例吧。在test_add.c檔案中加入測試用例
START_TEST(test_add)
{
 fail_unless(add(2, 3) == 5, "god, 2+3!=5"); 
}
END_TEST

    通過上面這種方式,我們定義了一個測試用例。該測試用例名字為test_add。並且我們通過巨集fail_unless這種方式,預期add(2, 3)會返回5,如果不返回5,那麼我們將輸出god, 2+3!=5這樣的資訊。同時,該測試用例沒有被PASS^_^,而是FAIL。

現在我們編譯test_add.c、test_main.c和add.c,這樣當然編譯不過去,因為我們還沒有寫實現程式碼。在add.c加入如下實現程式碼:
int add(int i, int j)
{
 return 0;
}

     在add.h裡面也加入相應的函式原型。

     這裡我們在實現程式碼裡返回0,是故意使測試用例不通過,因為在TDD裡面,講究不通過/通過/重構這麼一個持續過程。

     現在我們編譯程式碼,這樣當然能編譯過了。但是,到目前位置我們還沒有執行我們的測試用例。ok,是在test_add.c裡面新增我們的測試用例的時候了:
Suite *make_add_suite(void)
{
        Suite *s = suite_create("Add");//建立測試套件(我不知道,這麼翻譯對不對?^_^)
        TCase *tc_add = tcase_create("add");//建立測試用例集

        suite_add_tcase(s, tc_add);//把測試用例集加入到套件中
        tcase_add_test(tc_add, test_add);//把我們的測試用例加入到測試集中

        return s;
}

在unit_test.h中加入函式原型:Suite *make_add_suite(void);

ok,是時候介紹test_main.c的時候了,該檔案程式碼如下:
#include "unit_test.h"
#include <stdlib.h>

int main(void)
{
        int n;
        SRunner *sr;

        sr = srunner_create(make_add_suite());//把Suite加入到SRunner裡面

        srunner_run_all(sr, CK_NORMAL);//執行所有測試用例

        n = srunner_ntests_failed(sr);
        srunner_free(sr);

        return (n==0)? EXIT_SUCCESS: EXIT_FAILURE;
}

     我想聰明的朋友也猜到了,為什麼執行測試用例的主函式和測試用例本身分別放到不同原始檔的原因了。就是為了以後再新增測試用例的時候方便,例如:我現在又增加了減數sub程式,那麼為了保持清晰起見,針對sub的測試應該單獨組織原始檔test_sub.c,現在只需要在test_main.c中的SRunner中加入sub的Suite即可。

     現在編譯測試用例相關檔案,執行。就會看見我們的測試用例情況。多少通過,多少沒有通過,沒有通過的測試用例FAIL在那裡等等這些資訊。


    通過上面的介紹,可以發現Check測試框架和其它測試框架,例如CppUnit的使用方式差不多。其實,單純從使用測試框架本身的角度上來看,是非常簡單的。難的是,測試先行究竟該怎麼來做,怎麼樣來做好,當程式需要訪問資料庫時候,我們該怎麼樣來完成測試用例的編寫,這些都是難點。我決定了,明天出去買一本《測試驅動開發》看看,然後注意在編碼過程中,採用測試先行的方式。等我有了這方面的經驗,我會

拿出來和大家共享,也歡迎已經有這方面經驗的兄弟給出自己的心得,指正我上面文章中的錯誤,讓吾輩從中受益!!