cargo extension

Cargo 확장 명령 운영표

cargo-something 형식의 실행 파일을 Cargo 하위 명령처럼 쓰기 위해 운영 기준을 정리합니다.

도입 흐름
01

Name

실행 파일 이름은 cargo-접두사를 붙여 하위 명령으로 발견되게 합니다.

02

Path

명령어가 있는 디렉터리를 PATH에 두어 Cargo가 실행할 수 있게 합니다.

03

Contract

인자, 종료 코드, 출력 형식을 팀 자동화가 읽을 수 있게 고정합니다.

04

Scope

개인 보조 도구인지 작업공간 표준 도구인지 적용 범위를 나눕니다.

05

Verify

새 버전 도입 전 최소 프로젝트에서 실행과 실패 케이스를 확인합니다.

운영 기준

명령 규칙

`cargo fmt`처럼 짧고 예측 가능한 이름이 팀 도구로 쓰기 좋습니다.

표준화

반복 검증, 릴리즈 전 점검, 코드 생성처럼 팀 전체가 반복하는 일을 우선 후보로 둡니다.

출력 설계

사람용 설명과 자동화용 결과를 섞으면 CI에서 파싱이 어려워질 수 있습니다.

버전 정책

도구 자체도 의존성이므로 설치 버전과 변경 이력을 같이 관리합니다.

실패 처리

부분 성공, 권한 문제, 네트워크 실패 때 어떤 종료 코드를 낼지 정해 둡니다.

extension cue

Cargo 확장은 편리한 단축키가 아니라 팀 빌드와 검증 흐름에 들어갈 작은 제품처럼 다루면 안정적입니다.