[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/CD와 C++ GitHub Actions 멀티 OS 빌드를 함께 보세요.
의존성·빌드 도구 관점에서는 go mod가 언어에 내장된 반면, C++는 CMake와 Conan·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: 의존성 관리
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.mod와go.sum파일 이해 -
_test.go파일에 테스트 작성 -
testing.T로 유닛 테스트 - 테이블 주도 테스트 패턴 활용
-
testing.B로 벤치마크 작성 - 커버리지 측정 및 개선
- 실습 과제 4개 완료
C++에서 Go로 전환 포인트
| C++ | Go | 비고 |
|---|---|---|
| CMakeLists.txt | go.mod | 훨씬 간단 |
| vcpkg/Conan | go get | 한 줄로 끝 |
| Google Test | testing 패키지 | 내장 |
| CTest | go test | 내장 |
| gcov/lcov | go 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: 메모리와 자료구조 - 포인터 연산은 없지만 포인터는 있다