C++ 유닛 테스트 자동화: Google Test(GTest)로 신뢰성 높이기

✅ 유닛 테스트란 무엇인가요?

유닛 테스트(Unit Test)란 소프트웨어 개발에서 하나의 함수나 클래스 같은 최소 단위 단위의 코드가 정확히 동작하는지 검증하는 테스트입니다.
이런 테스트는 보통 자동화된 방식으로 실행되며, 코드 변경 시 버그가 발생했는지를 빠르게 확인할 수 있도록 도와줍니다.

특히 C++처럼 구조가 복잡하고 메모리 관리를 직접 해야 하는 언어에서는, 테스트를 통한 안정성 확보가 매우 중요합니다.
예상치 못한 예외나 논리 오류, 인터페이스 변경 등의 이슈를 사전에 잡아낼 수 있기 때문이죠.

• 🧪기능별 테스트 코드로 예상 결과와 실제 결과 비교
• 🛠️버그 발생 시 정확한 위치와 원인을 빠르게 파악
• 🔄리팩토링 후에도 동작이 유지되는지 검증

물론, 모든 기능을 유닛 테스트로 다 커버할 수는 없습니다.
하지만 핵심 로직이나 자주 변경되는 코드에 대해 유닛 테스트가 잘 작성되어 있다면 전체 시스템의 안정성은 크게 높아집니다.
또한 팀 개발 환경에서는 커밋 전에 테스트를 돌려보는 습관만으로도 수많은 장애를 예방할 수 있죠.

🛠️ Google Test(GTest) 설치 방법

Google Test(GTest)는 C++ 진영에서 가장 많이 사용되는 유닛 테스트 프레임워크입니다.
구글에서 직접 오픈소스로 관리하고 있으며, 다양한 플랫폼과 빌드 시스템을 지원해 활용도가 매우 높습니다.
간단한 설정만으로도 바로 테스트 코드를 작성하고 실행할 수 있어, 초보자도 쉽게 접근할 수 있다는 장점이 있습니다.

GTest 설치 방법은 사용하는 빌드 도구에 따라 조금씩 다르지만, 대표적으로 많이 사용하는 CMake 기반의 설치 과정을 예시로 들어 설명드릴게요.

# GoogleTest를 FetchContent로 설치하는 CMake 예제
include(FetchContent)

FetchContent_Declare(
  googletest
  URL https://github.com/google/googletest/archive/refs/heads/main.zip
)

FetchContent_MakeAvailable(googletest)

enable_testing()
add_executable(MyTest main_test.cpp)
target_link_libraries(MyTest gtest_main)
include(GoogleTest)
gtest_discover_tests(MyTest)

위 방식은 GoogleTest를 외부 라이브러리로 자동 다운로드하여 프로젝트 내부에 포함시키는 형태입니다.
추가적인 빌드 옵션 없이도 테스트 실행 파일이 생성되며, CTest와 통합하여 CI/CD 환경에서도 손쉽게 활용할 수 있습니다.

GTest 설치가 완료되면 이제부터는 다양한 테스트 케이스를 자유롭게 작성하고, 실행 결과를 통해 코드의 안정성을 높일 수 있게 됩니다.
이제 다음 단계에서는 GTest의 기본 구조와 주요 문법을 함께 살펴보겠습니다.

🔍 GTest 기본 구조와 주요 문법

Google Test는 간결하면서도 확장성 있는 문법 구조를 가지고 있습니다.
기본적인 테스트 함수 하나만으로도 다양한 조건 검증이 가능하며, 필요한 경우 Fixture 기반의 테스트 구성도 지원합니다.
처음 GTest를 접하시는 분들을 위해, 핵심적인 문법 구조를 아래 예제와 함께 정리해볼게요.

// 기본 테스트 예제
#include <gtest/gtest.h>

TEST(MathTest, Addition) {
    EXPECT_EQ(2 + 2, 4);
    EXPECT_NE(2 + 2, 5);
}

위 예제처럼 TEST() 매크로를 사용해 테스트 케이스를 작성할 수 있습니다.
매크로는 TEST(테스트 그룹명, 테스트 이름) 형식이며, 내부에는 여러 개의 검증 구문을 포함할 수 있습니다.

• ✅EXPECT_EQ(a, b) – 두 값이 같아야 통과
• ❌EXPECT_NE(a, b) – 두 값이 달라야 통과
• ⚠️ASSERT_TRUE(condition) – 조건이 true여야 테스트 통과

또한 ASSERT_* 계열은 실패 시 테스트를 즉시 중단하며, EXPECT_*는 실패해도 다음 라인까지 실행되는 차이점이 있습니다.
테스트 목적에 따라 두 가지를 적절히 조합해 사용하는 것이 중요합니다.

기본 구조를 이해했다면, 이제 다음으로는 실전 예제를 통해 실제 테스트 코드가 어떻게 작성되는지를 더 자세히 살펴보겠습니다.

📌 실전 예제로 배우는 테스트 작성법

기본 문법을 익혔다면 이제는 실제 프로젝트 코드에 테스트를 어떻게 적용하는지를 알아볼 차례입니다.
단순한 수학 계산이 아닌, 클래스와 객체를 다루는 예제를 중심으로 테스트 구성 방식을 이해해보겠습니다.

예를 들어, 간단한 Calculator 클래스가 있다고 가정해 보겠습니다.
이 클래스는 덧셈과 나눗셈을 처리하며, 나눗셈에서 0으로 나눌 경우 예외를 발생시킵니다.

class Calculator {
public:
    int Add(int a, int b) { return a + b; }
    int Divide(int a, int b) {
        if (b == 0) throw std::invalid_argument("Divide by zero");
        return a / b;
    }
};

이제 위 클래스를 테스트하는 GTest 코드는 다음과 같이 작성할 수 있습니다.

TEST(CalculatorTest, AddTest) {
    Calculator calc;
    EXPECT_EQ(calc.Add(3, 2), 5);
}

TEST(CalculatorTest, DivideTest) {
    Calculator calc;
    EXPECT_EQ(calc.Divide(10, 2), 5);
}

TEST(CalculatorTest, DivideByZeroTest) {
    Calculator calc;
    EXPECT_THROW(calc.Divide(10, 0), std::invalid_argument);
}

이처럼 실전 테스트에서는 단순한 값 비교 외에도 예외 처리, 경계 조건, 오류 상황까지 폭넓게 검증해야 합니다.
또한 여러 테스트 케이스가 실패 없이 통과할 수 있도록 코드 자체도 테스트 가능하게 구성하는 것이 중요하죠.

실전 테스트를 통해 실제 업무에서 발생할 수 있는 다양한 시나리오를 사전에 점검하고, 오류를 줄이는 개발 문화를 만들어갈 수 있습니다.
다음 단계에서는 이렇게 작성된 테스트를 CI/CD에 통합하는 방법을 알려드릴게요.

🚀 CI/CD 파이프라인에 테스트 통합하기

유닛 테스트는 단순히 로컬에서 실행하고 끝나는 것이 아니라, CI/CD 파이프라인에 자동으로 포함되어야 진정한 효과를 발휘합니다.
이렇게 하면 코드가 커밋될 때마다 테스트가 자동으로 실행되어, 오류를 조기에 발견하고 배포 품질을 유지할 수 있습니다.

CI 툴로는 GitHub Actions, GitLab CI, Jenkins, Travis CI 등이 있으며, 대부분 GTest를 손쉽게 통합할 수 있습니다.
그중에서도 GitHub Actions를 예로 들어 간단한 워크플로 구성을 보여드릴게요.

# .github/workflows/test.yml

name: Run GTest on push

on:
  push:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Install Dependencies
      run: sudo apt-get install cmake g++ -y
    - name: Configure
      run: cmake -Bbuild -H.
    - name: Build
      run: cmake --build build
    - name: Run Tests
      run: ctest --test-dir build

이 스크립트는 main 브랜치에 코드가 푸시될 때마다 자동으로 빌드하고, CMake를 이용해 테스트를 실행합니다.
이처럼 CI 환경에 테스트를 연결하면 실수로 인한 오류나 배포 실패를 방지할 수 있습니다.

• 🔄테스트가 실패하면 배포 중단
• 📦빌드-테스트-배포 흐름을 자동화
• 👥협업 중 코드 오류 발생 시 즉시 알림

CI/CD에 테스트를 연동하면 코드 품질이 눈에 띄게 향상되며, 운영 환경으로의 배포 안정성도 보장받을 수 있습니다.
이제 개발팀 전체가 테스트 자동화를 통해 더 안전하고 빠르게 소프트웨어를 릴리즈할 수 있는 환경을 갖추게 되는 셈이죠.

❓ 자주 묻는 질문 (FAQ)