도구 계약

도구 계약은 호출자가 공통 도구를 안전하게 사용할 수 있도록 입력, 결과, 부수 효과, 실패와 호환성 규칙을 공개한 약속이다. 명령줄 옵션과 함수 자료형뿐 아니라 설정 기본값, 읽고 쓰는 경로, 표준 출력·오류, 종료 상태, 네트워크 요청과 재시도 방식도 호출자가 관찰하면 계약에 포함된다.

도구 계약은 구현을 고정하는 문서가 아니다. 내부 구조는 바꿀 수 있되 호출자가 의존한 표면을 어떻게 유지하거나 이행할지 정한다. 출력 구조 규칙(schema)과 실패를 재현하는 예제(fixture)를 실행 가능한 검증으로 두면 문서와 구현이 조용히 달라지는 일을 줄일 수 있다.