코드 기반 테스트 매크로

CT 2025.06부터 코드 기반 테스트 기능을 통해 GTest(Google Test) 스타일의 테스트 매크로를 지원합니다.
이 페이지는 코드 기반 테스트에서 사용할 수 있는 매크로의 종류와 각각의 의미, 예제를 함께 안내합니다.

작성 중인 테스트 코드 편집기에서 Ctrl + Space 단축키를 누르면 자동완성 기능으로 매크로 목록을 확인할 수 있습니다.

테스트 정의 매크로

테스트 함수의 구조와 실행 단위를 정의하는 매크로입니다.

예제:

// 1. CTEST: 단순 테스트 케이스
CTEST(Math, Addition) {
    CTEST_ASSERT_EQ(5, Add(2, 3));
}
// 2. CTEST_F: 공통 fixture를 사용하는 테스트
class CalculatorFixture : public ::ctest::Fixture {
public:
    void SetUpTest() override {
        calculator.reset();
        initial_value = 100;
    }
    void TearDownTest() override {
        // 정리 작업 수행
    }
protected:
    Calculator calculator;
    int initial_value;
};
CTEST_F(CalculatorFixture, WithInitialValue) {
    calculator.setValue(initial_value);
    CTEST_ASSERT_EQ(105, calculator.add(5));
}
// 3. CTEST_P: 파라미터화 테스트
class EvenNumberTest : public ::ctest::TestWithParam<int> {
public:
    void SetUpTest() override {
        // 각 테스트 실행 전 초기화
    }
    void TearDownTest() override {
        // 각 테스트 실행 후 정리
    }
};
CTEST_P(EvenNumberTest, CheckIfEven) {
    int value = GetParam();
    CTEST_EXPECT(value % 2 == 0);
}
INSTANTIATE_CTEST_SUITE_P(EvenNumbers,
                         EvenNumberTest,
                         ::ctest::Values(0, 2, 4, 6, 8));

기본 조건 검사 매크로

단일 조건의 참/거짓 여부를 확인합니다.

값 비교 매크로

정수 또는 기타 일반 값의 비교 결과를 확인합니다.

문자열 비교 매크로

문자열의 동일 여부 또는 대소문자 무시 여부를 검사합니다.

실수 비교 매크로

부동소수점 값의 근사 비교를 수행합니다. 부동소수점은 정확한 값 비교가 어려우므로 허용 오차 범위 내에서 비교합니다.

예외 검사 매크로

코드 실행 중 예외 발생 여부를 확인합니다.

로그 출력 매크로

테스트 실행 중 디버깅이나 정보 확인을 위한 로그 메시지를 출력합니다.

Mock 관련 매크로

테스트용 가짜(Mock) 객체를 만들어 의존성을 제어하고 호출 결과를 검증할 때 사용합니다.

예제:

class MockFoo : public Foo {
    CMOCK_METHOD(int, Add, (int a, int b), const override);
};
CTEST(MockTest, AddCalled) {
    MockFoo mock;
    mock.SetReturn_Add(42);
    CTEST_ASSERT_EQ(42, mock.Add(2, 3));
}