Unit Test với Google Test (GTest) trên Linux

Google Test là Framework phát triển bởi Google dùng để thực hiện Unit test cho ngôn ngữ C/C++ (ai chưa rõ Unit Test là gì thì có thể tìm hiểu thêm tại đây). Google Test hỗ trợ nhiều nền tảng như Linux, Windows, MacOS X, Symbian, … và cho phép thực hiện Unit test dễ dàng hơn nhờ công cụ tạo dummy code rất mạnh mẽ là Google Mock.

Trong phạm vi bài viết này mình sẽ hướng dẫn anh em setup và sử dụng Google Test trên Ubuntu 14.04 (các phiên khác của Linux như Ubuntu 12.04, 16.04 hoặc Centos… cũng thực hiện tương tự).

Các bước thực hiện như sau →

1. Install source package của Gtest

Trên terminal gõ lệnh sau →

sudo apt-get install libgtest-dev

1	sudo apt-get install libgtest-dev

Sau khi kết thục lệnh này, source code của Gtest sẽ được download về đường dẫn /usr/src/gtest. Việc tiếp theo là build thư viện Gtest từ source code này.

2. Build thư viện Gtest

Cài đặt cmake →

sudo apt-get install cmake

1	sudo apt-get install cmake

Thực hiện build thư viện →

cd /usr/src/gtest
sudo cmake CMakeLists.txt
sudo make

cd /usr/src/gtest

sudo cmake CMakeLists.txt

sudo make

Copy thư viện Gtest vừa build vào đường dẫn /usr/lib →

sudo cp *.a /usr/lib

1	sudo cp *.a /usr/lib

3. Thực hiện Unit test với Gtest

Giả sử chúng ta cần thực hiện Unit test cho hàm tính diện tích hình vuông như sau →

// function_need_to_test.h

int retangleArea(int width, int height);

// function_need_to_test.h

int retangleArea(int width, int height);

// function_need_to_test.cpp
#include "function_need_to_test.h"

int retangleArea(int width, int height) {
    int area = 0;

    if (width > 0 && height > 0) {
        area = width*height;
    }

    return area;
}

// function_need_to_test.cpp

#include "function_need_to_test.h"

int retangleArea(int width, int height) {

int area = 0;

if (width > 0 && height > 0) {

area = width*height;

}

return area;

}

Tiếp theo tạo file test.cpp, trong này ta sẽ thực hiện 2 hàm test (gọi là 2 TESTS) đơn giản, một TEST cho các trường hợp tham số không hợp lệ, 1 TEST cho các tham số hợp lệ →

// test.cpp
#include "function_need_to_test.h"
#include <gtest/gtest.h>
 
TEST (RetangleAreaTest, InvalidParam) { 
    EXPECT_EQ(0, retangleArea(-1, 5));
    EXPECT_EQ(0, retangleArea(10, -2));
    EXPECT_EQ(0, retangleArea(0, 0));
}
 
TEST(RetangleAreaTest, ValidParam) {
    EXPECT_EQ(20, retangleArea(4, 5));
    EXPECT_EQ(10, retangleArea(5, 2));
    EXPECT_EQ(56, retangleArea(7, 8));
}
 
int main(int argc, char **argv) {
    testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

// test.cpp

#include "function_need_to_test.h"

#include <gtest/gtest.h>

TEST (RetangleAreaTest, InvalidParam) {

EXPECT_EQ(0, retangleArea(-1, 5));

EXPECT_EQ(0, retangleArea(10, -2));

EXPECT_EQ(0, retangleArea(0, 0));

}

TEST(RetangleAreaTest, ValidParam) {

EXPECT_EQ(20, retangleArea(4, 5));

EXPECT_EQ(10, retangleArea(5, 2));

EXPECT_EQ(56, retangleArea(7, 8));

}

int main(int argc, char **argv) {

testing::InitGoogleTest(&argc, argv);

return RUN_ALL_TESTS();

}

Cho 3 file function_need_to_test.h, function_need_to_test.cpp và test.cpp vào cùng 1 folder, ở ví dụ của mình là folder /home/tuanpm3/Gtest. Tạo file CMakeLists.txt trong cùng folder như sau →

cmake_minimum_required(VERSION 2.6)
 
# Locate GTest
find_package(GTest REQUIRED)
include_directories(${CMAKE_CURRENT_SOURCE_DIR})
include_directories(${GTEST_INCLUDE_DIRS})
 
# Link runTests with what we want to test and the GTest and pthread library
add_executable(runTests test.cpp function_need_to_test.cpp)
target_link_libraries(runTests ${GTEST_LIBRARIES} pthread)

cmake_minimum_required(VERSION 2.6)

# Locate GTest

find_package(GTest REQUIRED)

include_directories(${CMAKE_CURRENT_SOURCE_DIR})

include_directories(${GTEST_INCLUDE_DIRS})

# Link runTests with what we want to test and the GTest and pthread library

add_executable(runTests test.cpp function_need_to_test.cpp)

target_link_libraries(runTests ${GTEST_LIBRARIES} pthread)

4. Build và chạy Unit test

Di chuyển vào folder /home/tuanpm3/Gtest →

cd /home/tuanpm3/Gtest/

1	cd /home/tuanpm3/Gtest/

Tạo folder build →

mkdir build

1	mkdir build

Di chuyển vào folder build và tạo Makefile bằng lệnh cmake →

cd build
cmake ../ # khi cmake phai chi duong dan den Folder chua file CMakeLists.txt

1 2	cd build cmake ../ # khi cmake phai chi duong dan den Folder chua file CMakeLists.txt

Sau khi kết thúc lệnh cmake thì bên trong folder build đã có Makefile. Việc bây giờ là make để build file chạy →

make

make

Giờ thì chạy file runTests →

./runTests

1	./runTests

Kết quả test sẽ hiển thị ra như sau →

Anh em nếu hứng thú với Google Test có thể tìm hiểu thêm tại đây.

— Author: Phạm Minh Tuấn —

DEV quèn có tâm