[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상

[Go 2주 완성 #07] Day 12~13: 의존성 관리와 테스팅 - CMake보다 쉬운 세상

이 글의 핵심

go mod·go get·go.sum, 그리고 go test·테이블 테스트·벤치마크·커버리지까지 CMake·외부 테스트 프레임워크 없이 끝내는 흐름을 정리합니다. Day 12~13입니다.

시리즈 안내

📚 Go 2주 완성 시리즈 #07 | 전체 목차 보기

이 글은 C++ 개발자를 위한 2주 완성 Go 언어 커리큘럼Day 12~13 내용입니다.

이전: #06 고루틴·채널 ← | → 다음: #08 REST API 프로젝트

단위 테스트는 모든 언어에서 중요합니다. Python에서 pytest·CI, Node.js의 Jest, C++의 Google Test, Rust의 cargo test는 각각의 생태계에서 표준에 가깝습니다. 테스트를 파이프라인에 붙이려면 Node.js GitHub Actions CI/CDC++ GitHub Actions 멀티 OS 빌드를 함께 보세요.

의존성·빌드 도구 관점에서는 go mod가 언어에 내장된 반면, C++는 CMakeConan·vcpkg를 조합하는 경우가 많고, npm·node_modules·pip·uv·Poetry·Rust Cargo와 비교하면 “선언·락·재현 빌드” 패턴이 한눈에 정리됩니다. C++ 빌드 시스템 완전 비교도 함께 읽으면 좋습니다.


들어가며: 빌드 시스템의 혁명

C++에서 외부 라이브러리를 추가하려면 CMakeLists.txt를 수정하고, find_package를 설정하고, vcpkg나 Conan으로 의존성을 관리해야 했습니다. Go는 한 줄입니다. go get github.com/gin-gonic/gin. 끝입니다. 테스트도 마찬가지입니다. Google Test를 설치하고 설정할 필요 없이, go test만 실행하면 됩니다.

이 글에서 배울 내용:

  • Go Modules로 의존성 관리
  • go get으로 라이브러리 추가
  • go test로 유닛 테스트 작성
  • 테이블 주도 테스트와 벤치마크

목차

  1. Go Modules: 의존성 관리
  2. 외부 라이브러리 사용
  3. 유닛 테스트 작성
  4. 테이블 주도 테스트
  5. 벤치마크와 커버리지
  6. 실습 과제

1. Go Modules: 의존성 관리

C++ vs Go: 프로젝트 초기화

# C++: CMakeLists.txt
cmake_minimum_required(VERSION 3.15)
project(MyProject)

set(CMAKE_CXX_STANDARD 17)

# 외부 라이브러리 찾기
find_package(Boost REQUIRED)
find_package(OpenSSL REQUIRED)

# vcpkg 설정
# ...

add_executable(myapp main.cpp)
target_link_libraries(myapp Boost::boost OpenSSL::SSL)
# Go: 모듈 초기화 (한 줄)
go mod init myproject

# 생성된 go.mod
# module myproject
# 
# go 1.21

의존성 추가

# C++: vcpkg 또는 Conan
vcpkg install boost openssl
# 또는
conan install . --build=missing

# CMakeLists.txt 수정 필요
# Go: go get (한 줄)
go get github.com/gin-gonic/gin@latest
go get github.com/stretchr/[email protected]

# go.mod에 자동 추가됨

go.mod 파일 구조

// go.mod
module myproject

go 1.21

require (
    github.com/gin-gonic/gin v1.9.1
    github.com/stretchr/testify v1.8.4
)

// 간접 의존성 (자동 관리)
require (
    github.com/gin-contrib/sse v0.1.0 // indirect
    github.com/go-playground/validator/v10 v10.14.0 // indirect
    // ...
)

주요 go 명령어

# 모듈 관리
go mod init myproject      # 모듈 초기화
go mod tidy                # 불필요한 의존성 제거
go mod download            # 의존성 다운로드
go mod verify              # 의존성 무결성 검증

# 의존성 추가/업데이트
go get package@latest      # 최신 버전
go get [email protected]      # 특정 버전
go get -u                  # 모든 의존성 업데이트

# 빌드
go build                   # 현재 디렉토리
go build ./...             # 모든 하위 패키지
go build -o myapp          # 출력 파일명 지정

# 실행
go run main.go             # 컴파일 + 실행

2. 외부 라이브러리 사용

실전 예시: HTTP 서버 (Gin 프레임워크)

# 의존성 추가
go get github.com/gin-gonic/gin
// main.go
package main

import (
    "github.com/gin-gonic/gin"
    "net/http"
)

func main() {
    r := gin.Default()
    
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "pong",
        })
    })
    
    r.Run(":8080")
}
# 실행
go run main.go

# 빌드
go build -o server
./server

3. 유닛 테스트 작성

C++ vs Go: 테스트 프레임워크

// C++: Google Test 설치 및 설정 필요
#include <gtest/gtest.h>

int Add(int a, int b) {
    return a + b;
}

TEST(MathTest, AddPositive) {
    EXPECT_EQ(Add(2, 3), 5);
}

TEST(MathTest, AddNegative) {
    EXPECT_EQ(Add(-2, -3), -5);
}

int main(int argc, char **argv) {
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

// CMakeLists.txt에 Google Test 설정 추가 필요
// Go: 내장 testing 패키지 (설치 불필요)
// math.go
package math

func Add(a, b int) int {
    return a + b
}

// math_test.go
package math

import "testing"

func TestAddPositive(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2, 3) = %d; want 5", result)
    }
}

func TestAddNegative(t *testing.T) {
    result := Add(-2, -3)
    if result != -5 {
        t.Errorf("Add(-2, -3) = %d; want -5", result)
    }
}
# 테스트 실행
go test                    # 현재 패키지
go test ./...              # 모든 하위 패키지
go test -v                 # 상세 출력
go test -run TestAddPositive  # 특정 테스트만

테스트 헬퍼 함수

// Go: 테스트 헬퍼
package math

import "testing"

func assertEqual(t *testing.T, got, want int) {
    t.Helper()  // 에러 발생 시 호출자 라인 표시
    if got != want {
        t.Errorf("got %d; want %d", got, want)
    }
}

func TestAdd(t *testing.T) {
    assertEqual(t, Add(2, 3), 5)
    assertEqual(t, Add(-2, -3), -5)
    assertEqual(t, Add(0, 0), 0)
}

4. 테이블 주도 테스트

테이블 주도 테스트 패턴

// Go: 테이블 주도 테스트 (권장 패턴)
package math

import "testing"

func TestAdd(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        expected int
    }{
        {"positive numbers", 2, 3, 5},
        {"negative numbers", -2, -3, -5},
        {"zero", 0, 0, 0},
        {"mixed", -5, 10, 5},
        {"large numbers", 1000000, 2000000, 3000000},
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result := Add(tt.a, tt.b)
            if result != tt.expected {
                t.Errorf("Add(%d, %d) = %d; want %d", 
                    tt.a, tt.b, result, tt.expected)
            }
        })
    }
}

실행 결과:

$ go test -v
=== RUN   TestAdd
=== RUN   TestAdd/positive_numbers
=== RUN   TestAdd/negative_numbers
=== RUN   TestAdd/zero
=== RUN   TestAdd/mixed
=== RUN   TestAdd/large_numbers
--- PASS: TestAdd (0.00s)
    --- PASS: TestAdd/positive_numbers (0.00s)
    --- PASS: TestAdd/negative_numbers (0.00s)
    --- PASS: TestAdd/zero (0.00s)
    --- PASS: TestAdd/mixed (0.00s)
    --- PASS: TestAdd/large_numbers (0.00s)
PASS

서브테스트 활용

// Go: 서브테스트로 구조화
func TestMath(t *testing.T) {
    t.Run("Add", func(t *testing.T) {
        if Add(2, 3) != 5 {
            t.Error("Add failed")
        }
    })
    
    t.Run("Subtract", func(t *testing.T) {
        if Subtract(5, 3) != 2 {
            t.Error("Subtract failed")
        }
    })
    
    t.Run("Multiply", func(t *testing.T) {
        if Multiply(2, 3) != 6 {
            t.Error("Multiply failed")
        }
    })
}

5. 벤치마크와 커버리지

벤치마크

// Go: 벤치마크 (함수명 BenchmarkXxx)
package math

import "testing"

func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(2, 3)
    }
}

func BenchmarkAddLarge(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(1000000, 2000000)
    }
}
# 벤치마크 실행
$ go test -bench=.
BenchmarkAdd-8          1000000000    0.25 ns/op
BenchmarkAddLarge-8     1000000000    0.26 ns/op
PASS

# 메모리 할당 측정
$ go test -bench=. -benchmem
BenchmarkAdd-8          1000000000    0.25 ns/op    0 B/op    0 allocs/op

커버리지

# 커버리지 측정
go test -cover
# PASS
# coverage: 85.7% of statements

# 상세 커버리지 리포트
go test -coverprofile=coverage.out
go tool cover -html=coverage.out  # HTML 리포트 생성

테스트 모킹

// Go: 인터페이스로 모킹
package user

import "testing"

// 인터페이스 정의
type UserStore interface {
    Get(id int) (*User, error)
    Save(u *User) error
}

// 프로덕션 구현
type DBUserStore struct {
    // DB 연결...
}

func (s *DBUserStore) Get(id int) (*User, error) {
    // 실제 DB 조회
    return nil, nil
}

// 테스트용 모의 구현
type MockUserStore struct {
    users map[int]*User
}

func NewMockUserStore() *MockUserStore {
    return &MockUserStore{
        users: make(map[int]*User),
    }
}

func (m *MockUserStore) Get(id int) (*User, error) {
    if user, ok := m.users[id]; ok {
        return user, nil
    }
    return nil, errors.New("not found")
}

func (m *MockUserStore) Save(u *User) error {
    m.users[u.ID] = u
    return nil
}

// 서비스 (인터페이스에 의존)
type UserService struct {
    store UserStore
}

func NewUserService(store UserStore) *UserService {
    return &UserService{store: store}
}

func (s *UserService) GetUser(id int) (*User, error) {
    return s.store.Get(id)
}

// 테스트
func TestUserService_GetUser(t *testing.T) {
    // 모의 스토어 사용
    mockStore := NewMockUserStore()
    mockStore.Save(&User{ID: 1, Name: "Alice"})
    
    service := NewUserService(mockStore)
    
    user, err := service.GetUser(1)
    if err != nil {
        t.Fatal(err)
    }
    
    if user.Name != "Alice" {
        t.Errorf("got %s; want Alice", user.Name)
    }
}

6. 실습 과제

과제 1: 문자열 유틸리티 테스트

// string_utils.go
package utils

import "strings"

func Reverse(s string) string {
    runes := []rune(s)
    for i, j := 0, len(runes)-1; i < j; i, j = i+1, j-1 {
        runes[i], runes[j] = runes[j], runes[i]
    }
    return string(runes)
}

func IsPalindrome(s string) bool {
    s = strings.ToLower(s)
    return s == Reverse(s)
}

func WordCount(s string) int {
    return len(strings.Fields(s))
}
// string_utils_test.go
package utils

import "testing"

func TestReverse(t *testing.T) {
    tests := []struct {
        input    string
        expected string
    }{
        {"hello", "olleh"},
        {"Go", "oG"},
        {"", ""},
        {"a", "a"},
        {"안녕하세요", "요세하녕안"},
    }
    
    for _, tt := range tests {
        t.Run(tt.input, func(t *testing.T) {
            result := Reverse(tt.input)
            if result != tt.expected {
                t.Errorf("Reverse(%q) = %q; want %q", 
                    tt.input, result, tt.expected)
            }
        })
    }
}

func TestIsPalindrome(t *testing.T) {
    tests := []struct {
        input    string
        expected bool
    }{
        {"racecar", true},
        {"hello", false},
        {"A man a plan a canal Panama", false},  // 공백 포함
        {"", true},
        {"a", true},
    }
    
    for _, tt := range tests {
        t.Run(tt.input, func(t *testing.T) {
            result := IsPalindrome(tt.input)
            if result != tt.expected {
                t.Errorf("IsPalindrome(%q) = %v; want %v", 
                    tt.input, result, tt.expected)
            }
        })
    }
}

func TestWordCount(t *testing.T) {
    tests := []struct {
        input    string
        expected int
    }{
        {"hello world", 2},
        {"Go is awesome", 3},
        {"", 0},
        {"   spaces   ", 1},
    }
    
    for _, tt := range tests {
        result := WordCount(tt.input)
        if result != tt.expected {
            t.Errorf("WordCount(%q) = %d; want %d", 
                tt.input, result, tt.expected)
        }
    }
}

과제 2: HTTP 핸들러 테스트

// handler.go
package main

import (
    "encoding/json"
    "net/http"
)

type Response struct {
    Message string `json:"message"`
    Status  string `json:"status"`
}

func PingHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != http.MethodGet {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }
    
    resp := Response{
        Message: "pong",
        Status:  "ok",
    }
    
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(resp)
}
// handler_test.go
package main

import (
    "encoding/json"
    "net/http"
    "net/http/httptest"
    "testing"
)

func TestPingHandler(t *testing.T) {
    // 요청 생성
    req := httptest.NewRequest(http.MethodGet, "/ping", nil)
    
    // 응답 기록기
    w := httptest.NewRecorder()
    
    // 핸들러 호출
    PingHandler(w, req)
    
    // 상태 코드 검증
    if w.Code != http.StatusOK {
        t.Errorf("got status %d; want %d", w.Code, http.StatusOK)
    }
    
    // 응답 본문 검증
    var resp Response
    if err := json.NewDecoder(w.Body).Decode(&resp); err != nil {
        t.Fatal(err)
    }
    
    if resp.Message != "pong" {
        t.Errorf("got message %s; want pong", resp.Message)
    }
    
    if resp.Status != "ok" {
        t.Errorf("got status %s; want ok", resp.Status)
    }
}

func TestPingHandler_InvalidMethod(t *testing.T) {
    req := httptest.NewRequest(http.MethodPost, "/ping", nil)
    w := httptest.NewRecorder()
    
    PingHandler(w, req)
    
    if w.Code != http.StatusMethodNotAllowed {
        t.Errorf("got status %d; want %d", 
            w.Code, http.StatusMethodNotAllowed)
    }
}

과제 3: 벤치마크 작성

// fibonacci.go
package math

func Fibonacci(n int) int {
    if n <= 1 {
        return n
    }
    return Fibonacci(n-1) + Fibonacci(n-2)
}

func FibonacciMemo(n int) int {
    memo := make(map[int]int)
    return fibMemo(n, memo)
}

func fibMemo(n int, memo map[int]int) int {
    if n <= 1 {
        return n
    }
    
    if v, ok := memo[n]; ok {
        return v
    }
    
    memo[n] = fibMemo(n-1, memo) + fibMemo(n-2, memo)
    return memo[n]
}
// fibonacci_test.go
package math

import "testing"

func BenchmarkFibonacci(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Fibonacci(20)
    }
}

func BenchmarkFibonacciMemo(b *testing.B) {
    for i := 0; i < b.N; i++ {
        FibonacciMemo(20)
    }
}
# 벤치마크 실행
$ go test -bench=.
BenchmarkFibonacci-8            30000     50000 ns/op
BenchmarkFibonacciMemo-8      5000000       300 ns/op
PASS

# 메모이제이션이 약 166배 빠름!

과제 4: 테스트 커버리지 개선

// calculator.go
package calc

import "errors"

func Divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("division by zero")
    }
    return a / b, nil
}

func SafeDivide(a, b float64) float64 {
    result, err := Divide(a, b)
    if err != nil {
        return 0
    }
    return result
}
// calculator_test.go
package calc

import "testing"

func TestDivide(t *testing.T) {
    tests := []struct {
        name      string
        a, b      float64
        expected  float64
        shouldErr bool
    }{
        {"normal", 10, 2, 5, false},
        {"zero dividend", 0, 5, 0, false},
        {"zero divisor", 10, 0, 0, true},
        {"negative", -10, 2, -5, false},
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result, err := Divide(tt.a, tt.b)
            
            if tt.shouldErr {
                if err == nil {
                    t.Error("expected error, got nil")
                }
            } else {
                if err != nil {
                    t.Errorf("unexpected error: %v", err)
                }
                if result != tt.expected {
                    t.Errorf("got %f; want %f", result, tt.expected)
                }
            }
        })
    }
}

func TestSafeDivide(t *testing.T) {
    tests := []struct {
        name     string
        a, b     float64
        expected float64
    }{
        {"normal", 10, 2, 5},
        {"zero divisor", 10, 0, 0},  // 에러 시 0 반환
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result := SafeDivide(tt.a, tt.b)
            if result != tt.expected {
                t.Errorf("got %f; want %f", result, tt.expected)
            }
        })
    }
}
# 커버리지 확인
$ go test -cover
PASS
coverage: 100.0% of statements

정리: Day 12~13 학습 체크리스트

완료해야 할 항목

  • go mod init으로 모듈 초기화
  • go get으로 의존성 추가
  • go.modgo.sum 파일 이해
  • _test.go 파일에 테스트 작성
  • testing.T로 유닛 테스트
  • 테이블 주도 테스트 패턴 활용
  • testing.B로 벤치마크 작성
  • 커버리지 측정 및 개선
  • 실습 과제 4개 완료

C++에서 Go로 전환 포인트

C++Go비고
CMakeLists.txtgo.mod훨씬 간단
vcpkg/Conango get한 줄로 끝
Google Testtesting 패키지내장
CTestgo test내장
gcov/lcovgo test -cover내장

Go 빌드 시스템의 장점

graph LR
    A[C++ 빌드] --> B[CMake 설정]
    B --> C[의존성 관리]
    C --> D[빌드 실행]
    D --> E[테스트 설정]
    E --> F[테스트 실행]
    
    G[Go 빌드] --> H[go build]
    G --> I[go test]
    
    style A fill:#ffcccc
    style G fill:#ccffcc

Go의 장점:

  • ✅ 빌드 시스템 내장
  • ✅ 의존성 관리 자동화
  • ✅ 테스트 프레임워크 내장
  • ✅ 크로스 컴파일 간단
# 크로스 컴파일 (C++에서는 복잡)
GOOS=linux GOARCH=amd64 go build    # Linux 64비트
GOOS=windows GOARCH=amd64 go build  # Windows 64비트
GOOS=darwin GOARCH=arm64 go build   # macOS ARM

다음 단계 예고

Day 12~13에서는 의존성 관리와 테스팅을 배웠습니다. 마지막 Day 14에서는 지금까지 배운 모든 것을 통합하여 실전 REST API 서버를 구축합니다!


📚 시리즈 네비게이션

이전 글목차다음 글
← #06 고루틴·채널📑 전체 목차#08 REST API →

Go 2주 완성 시리즈: 커리큘럼#01 기본 문법#02 자료구조#03 객체지향#04 인터페이스#05 에러 처리#06 고루틴·채널#07 테스팅#08 REST API#09 context·우아한 종료


한 줄 요약: Go Modules는 CMake보다 수백 배 쉽고, go test는 외부 프레임워크 없이 모든 것을 제공합니다.

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

  • [Go 2주 완성 #06] Day 10~11: 고루틴과 채널 - 동시성 프로그래밍의 혁명
  • [Go 2주 완성 #08] Day 14: REST API 미니 프로젝트
  • [Go 심화 #09] context·우아한 종료
  • C++ 개발자를 위한 2주 완성 Go 언어(Golang) 마스터 커리큘럼
  • C++ CMake 완벽 가이드 | 크로스 플랫폼 빌드·최신 CMake 3.28+ 기능·프리셋·모듈

이 글에서 다루는 키워드 (관련 검색어)

Go modules, go mod tidy, go test, 벤치마크 Go, 테스트 커버리지, CMake 대체, Golang 의존성, Go 2주 완성 등으로 검색하시면 이 글이 도움이 됩니다.

실전 팁

실무에서 바로 적용할 수 있는 팁입니다.

디버깅 팁

  • 문제가 발생하면 먼저 컴파일러 경고를 확인하세요
  • 간단한 테스트 케이스로 문제를 재현하세요

성능 팁

  • 프로파일링 없이 최적화하지 마세요
  • 측정 가능한 지표를 먼저 설정하세요

코드 리뷰 팁

  • 코드 리뷰에서 자주 지적받는 부분을 미리 체크하세요
  • 팀의 코딩 컨벤션을 따르세요

실전 체크리스트

실무에서 이 개념을 적용할 때 확인해야 할 사항입니다.

코드 작성 전

  • 이 기법이 현재 문제를 해결하는 최선의 방법인가?
  • 팀원들이 이 코드를 이해하고 유지보수할 수 있는가?
  • 성능 요구사항을 만족하는가?

코드 작성 중

  • 컴파일러 경고를 모두 해결했는가?
  • 엣지 케이스를 고려했는가?
  • 에러 처리가 적절한가?

코드 리뷰 시

  • 코드의 의도가 명확한가?
  • 테스트 케이스가 충분한가?
  • 문서화가 되어 있는가?

이 체크리스트를 활용하여 실수를 줄이고 코드 품질을 높이세요.


자주 묻는 질문 (FAQ)

Q. 이 내용을 실무에서 언제 쓰나요?

A. C++의 복잡한 CMake, vcpkg 설정에서 벗어나 Go Modules로 간단하게 의존성을 관리하세요. 외부 프레임워크 없이 go test만으로 유닛 테스트, 벤치마크, 커버리지까지 모두 처리합니다. 실무에서는 위 본문의 예제와 선택 가이드를 참고해 적용하면 됩니다.

Q. 선행으로 읽으면 좋은 글은?

A. 각 글 하단의 이전 글 또는 관련 글 링크를 따라가면 순서대로 배울 수 있습니다. C++ 시리즈 목차에서 전체 흐름을 확인할 수 있습니다.

Q. 더 깊이 공부하려면?

A. cppreference와 해당 라이브러리 공식 문서를 참고하세요. 글 말미의 참고 자료 링크도 활용하면 좋습니다.


관련 글

  • C++ 개발자를 위한 2주 완성 Go 언어(Golang) 마스터 커리큘럼
  • C++ vs Go | 성능·동시성·선택 가이드 완전 비교 [#47-1]
  • C++ 개발자의 뇌 구조로 이해하는 Go 언어 [#47-2]
  • [Go 2주 완성 #01] Day 1~2: Go 언어의 철학과 기본 문법 - C++ 개발자의 첫인상
  • [Go 2주 완성 #02] Day 3~4: 메모리와 자료구조 - 포인터 연산은 없지만 포인터는 있다