학습 테스트

• 잘 모르는 기능, 라이브러리, 프레임워크를 학습하기 위해 작성하는 테스트
• 여러 테스트 케이스를 스스로 정의하고 검증하는 과정을 통해 보다 구체적인 동작과 기능을 학습할 수 있다.
• 관련 문서만 읽는 것보다 훨씬 재미있게 학습할 수 있다.

Spring REST Docs

• 테스트 코드를 통한 API 문서 자동화 도구
• API 명세를 문서로 만들고 외부에 제공함으로써 협업을 원활하게 한다.
• 기본적으로 AsciiDoc를 사용하여 문서를 작성한다.

REST Docs vs Swagger

REST Docs

장점

• 테스트를 통과해야 문서가 만들어진다.(신뢰도가 높다.)
• 프로덕션 코드에 비침투적이다.

단점

• 코드 양이 많다.
• 설정이 어렵다.

Swagger

장점

• 적용이 쉽다.
• 문서에서 바로 API 호출을 수행해볼 수 있다.

단점

• 프로덕션 코드에 침투적이다.
• 테스트와 무관하기 때문에 신뢰도가 떨어질 수 있다.

---

출처 - 박우빈, Practical Testing: 실용적인 테스트 가이드
이 블로그에 포함된 모든 코드와 이미지는 원작자이신 박우빈 강사님의 저작권에 귀속됩니다.