1. 程式人生 > >(轉)使用CUnit進行單元測試和覆蓋率統計

(轉)使用CUnit進行單元測試和覆蓋率統計

CUnit安裝

如果能聯網的話,直接

yum install CUnit-devel.x86_64

就完成安裝了,注意要安裝devel版本,這樣才能找到標頭檔案。

編寫單元測試程式碼

CUnit的測試是單執行緒啟動,只能註冊一個Test Registry, 一次測試(Test Registry)可以執行多個測試包(Test Suite),而每個測試包可以包括多個測試用例(Test Case),每個測試用例又包含一個或者多個斷言類的語句。

具體到程式的結構上,一次測試下轄多個Test Suite,它對應於程式中各個獨立模組;一個Suite管理多個Test Case,它對應於模組內部函式實現。每個Suite可以含有setup和teardown函式,分別在執行suite的前後呼叫。

以下給出一個最簡單的示例程式碼,用的時候,把示例程式碼直接拷貝走,按自己的實際code,稍微改動一下,就可以用了。

程式碼包括4個檔案:

  • module.c
  • module.h 前兩個檔案是我們待測試的模組程式碼。為了簡單起見,這裡面只有一個函式。
  • cunit_sample.c:測試程式碼所在檔案。簡單起見,這裡只有一個檔案,實際可能會將不同模組的測試程式碼放到不同的檔案中。
  • Makefile: 執行make clean all生成測試的可執行檔案。

原始碼

module.c

int func1(int k) { if (k < 10) { return k; } else { return k + 1; } } 

module.h

#ifndef __CUNIT_SAMPLE_MODULE_
#define __CUNIT_SAMPLE_MODULE_

int func1(int k); #endif 

cunit_sample.c

#include <stdio.h>
#include "CUnit.h" #include "Automated.h" #include "module.h" void utcase_first_case() { int ret = 0; ret = func1(10); CU_ASSERT_EQUAL(ret, 11); } static CU_TestInfo ut_cases[] = { {"case:first_case", utcase_first_case}, // add more cases here CU_TEST_INFO_NULL, }; int suite_init(void) { return 0; } int suite_clean(void) { return 0; } static CU_SuiteInfo ut_suites[] = { {"my_first_suite", suite_init, suite_clean, ut_cases}, CU_SUITE_INFO_NULL, }; int main() { int rc = 0; CU_ErrorCode err = CUE_SUCCESS; err = CU_initialize_registry(); if (err != CUE_SUCCESS) { fprintf(stderr, "failed to initialize registry, error %d", err); rc = 1; goto l_out; } err = CU_register_suites(ut_suites); if (err != CUE_SUCCESS) { fprintf(stderr, "failed to register suites, error %d, %s", err, CU_get_error_msg()); rc = 1; goto l_clean_register; } CU_set_output_filename("cunit_sample"); err = CU_list_tests_to_file(); if (err != CUE_SUCCESS) { fprintf(stderr, "failed to list tests to file, error %d, %s", err, CU_get_error_msg()); rc = 1; goto l_clean_register; } CU_automated_run_tests(); l_clean_register: CU_cleanup_registry(); l_out: return rc; } 

Makefile

NY: all clean
RM = rm
RMFLAGS = -fr
CC = gcc

INC = -I /usr/include/CUnit -I .
LIBS = /usr/lib64/libcunit.so
CFLAGS = -fprofile-arcs -ftest-coverage
CFLAGS += $(INC)
BIN = cunit_sample
all: module.c module.h cunit_sample.c $(CC) $(CFLAGS) -o module.o -c module.c $(CC) $(CFLAGS) -o cunit_sample.o -c cunit_sample.c $(CC) $(CFLAGS) $(LIBS) -o $(BIN) module.o cunit_sample.o clean: $(RM) $(RMFLAGS) $(BIN) *.o *.gcda *.gcno *.xml 

執行測試用例

執行make clean all後,生成cunit_sample這個可執行檔案,直接執行,成功後,會生成兩個xml檔案,開啟cunit_sample-Results.xml,就可以看到每個測試用例的執行結果了。

覆蓋率統計

安裝lcov

lcov是一個覆蓋率的視覺化工具,使用

yum install lcov
即可完成安裝

在執行測試用例完成後,在原始碼所在的目錄下(一般我們要看的是原始碼的覆蓋率),使用以下兩個命令,生成程式碼覆蓋率的視覺化結果:

lcov -c -d ./ -o app.info # 指定當前目錄,也可以指定其它目錄

順利的話,會生成app.info檔案
最後一步:

genhtml app.info -o cc_result

順利的話,會生成cc_result的目錄,裡面就是覆蓋率的統計結果,使用瀏覽器開啟cc_result/index.html即可。

視覺效果如下圖:

  程式碼覆蓋率統計

可以點選任何一個檔案,檢視某個檔案的具體覆蓋資訊,這裡不就贅述了,希望本文可以幫到你。



作者:Jiang阿涵
連結:https://www.jianshu.com/p/b0bffd44d2c9
來源:簡書
簡書著作權歸作者所有,任何形式的轉載都請聯絡作者獲得授權並註明出處。