테스트 주도 개발
철학
핵심 원칙: 테스트는 구현 세부 사항이 아닌 공개 인터페이스를 통해 동작을 검증해야 합니다. 코드는 완전히 변경될 수 있지만, 테스트는 변경되지 않아야 합니다.
좋은 테스트는 통합 스타일입니다. 실제 코드 경로를 공개 API를 통해 실행합니다. 시스템이 무엇을 하는지 설명하고 어떻게 하는지는 설명하지 않습니다. 좋은 테스트는 명세서처럼 읽힙니다. "사용자가 유효한 장바구니로 결제할 수 있음"은 정확히 어떤 기능이 존재하는지 알려줍니다. 이러한 테스트는 내부 구조에 신경 쓰지 않기 때문에 리팩터링에도 견딥니다.
나쁜 테스트는 구현에 결합되어 있습니다. 내부 협력 객체를 목(mock)으로 대체하고, 비공개(private) 메서드를 테스트하거나, 외부 수단(데이터베이스를 인터페이스 대신 직접 조회하는 등)을 통해 검증합니다. 경고 신호: 동작은 변경되지 않았지만 리팩터링할 때 테스트가 깨집니다. 내부 함수 이름을 바꿨는데 테스트가 실패한다면, 그 테스트는 구현을 테스트한 것이지 동작을 테스트한 것이 아닙니다.
예시는 tests.md를, 목킹 지침은 mocking.md를 참조하세요.
안티패턴: 수평 슬라이스(Horizontal Slice)
모든 테스트를 먼저 작성하고, 그다음에 모든 구현을 작성하지 마세요. 이것은 "수평 슬라이싱"입니다. RED를 "모든 테스트 작성", GREEN을 "모든 코드 작성"으로 취급하는 것입니다.
이것은 형편없는 테스트를 만듭니다:
- 벌크로 작성된 테스트는 실제 동작이 아닌 상상된 동작을 테스트합니다.
- 결국 사용자 대면 동작이 아닌 것들의 형태(데이터 구조, 함수 시그니처)를 테스트하게 됩니다.
- 테스트는 실제 변경에 둔감해집니다. 동작이 깨져도 통과하고, 동작이 정상이어도 실패합니다.
- 구현을 이해하기 전에 테스트 구조에 전념하게 되면서 앞을 내다보지 못하게 됩니다.
올바른 접근 방식: 추적탄(tracer bullet)을 통한 수직 슬라이스. 하나의 테스트 → 하나의 구현 → 반복. 각 테스트는 이전 주기에서 배운 내용에 응답합니다. 방금 코드를 작성했기 때문에 어떤 동작이 중요하고 어떻게 검증할지 정확히 알 수 있습니다.
잘못된 예 (수평):
RED: test1, test2, test3, test4, test5
GREEN: impl1, impl2, impl3, impl4, impl5
올바른 예 (수직):
RED→GREEN: test1→impl1
RED→GREEN: test2→impl2
RED→GREEN: test3→impl3
...
워크플로우
1. 계획 수립
코드를 작성하기 전에:
- 사용자와 필요한 인터페이스 변경 사항을 확인
- 사용자와 테스트할 동작을 확인 (우선순위 지정)
- 깊은 모듈 기회 식별 (작은 인터페이스, 깊은 구현)
- 테스트 용이성을 위한 인터페이스 설계
- 테스트할 동작 나열 (구현 단계 아님)
- 계획에 대한 사용자 승인 받기
질문: "공개 인터페이스는 어떻게 되어야 합니까? 어떤 동작을 가장 중요하게 테스트해야 합니까?"
모든 것을 테스트할 수는 없습니다. 사용자와 정확히 어떤 동작이 가장 중요한지 확인하세요. 가능한 모든 엣지 케이스가 아닌, 중요한 경로와 복잡한 로직에 테스트 노력을 집중하세요.
2. 추적탄(Tracer Bullet)
시스템에 대해 하나의 사실을 확인하는 하나의 테스트를 작성하세요:
RED: 첫 번째 동작에 대한 테스트 작성 → 테스트 실패
GREEN: 통과할 수 있는 최소 코드 작성 → 테스트 통과
이것이 추적탄입니다. 경로가 종단 간(end-to-end) 작동함을 증명합니다.
3. 점진적 루프
남은 각 동작에 대해:
RED: 다음 테스트 작성 → 실패
GREEN: 통과할 최소 코드 → 통과
규칙:
- 한 번에 하나의 테스트
- 현재 테스트를 통과할 충분한 코드만
- 미래의 테스트를 예측하지 않음
- 테스트는 관찰 가능한 동작에 집중
4. 리팩터링
모든 테스트가 통과한 후, 리팩터링 후보를 찾으세요:
- 중복 추출
- 모듈 심화 (복잡성을 단순한 인터페이스 뒤로 이동)
- 자연스러운 곳에 SOLID 원칙 적용
- 새로운 코드가 기존 코드에 대해 무엇을 드러내는지 고려
- 각 리팩터링 단계 후 테스트 실행
RED 상태에서는 절대 리팩터링하지 마세요. 먼저 GREEN 상태로 만드세요.
주기별 체크리스트
[ ] 테스트가 구현이 아닌 동작을 설명하는가?
[ ] 테스트가 공개 인터페이스만 사용하는가?
[ ] 내부 리팩터링 후에도 테스트가 유지되는가?
[ ] 코드가 이 테스트를 위해 최소한인가?
[ ] 예측된 기능이 추가되지 않았는가?