CLI는 단일 파일과 패키지에 같은 구문 분석·모듈 해석·타입 검사를 적용하고, 요청한 작업만 다르게 실행합니다.
기본 규칙
check는 검사, run은 해석기 실행, test는 테스트 호스트 실행, emit은 Rust 소스 출력, build는 타겟 산출물 생성을 담당합니다. doc, fmt, LSP, 마이그레이션 명령도 같은 프로그램 해석 규칙을 공유합니다.
사용 방법
빠른 피드백은 check, 기준 실행 결과는 run, 배포 산출물은 build를 사용하세요. --root는 모듈과 패키지의 기준 경로를 지정하고, --locked는 잠금 파일이 매니페스트와 다르면 컴파일 전에 멈춥니다. --format json은 도구가 읽기 쉬운 진단을 출력합니다.
현재 지원
v5.6 CLI는 파일과 패키지 모드, 사람용·JSON 진단, 오류 코드 설명, 프로그램 인수 전달을 지원합니다. 정적 오류는 실행과 산출물 생성 전에 보고됩니다.
제한 사항
진단 출력은 소스 위치, 안정적인 오류 코드, 요약, 필요한 세부 정보를 포함합니다. 호스트 컴파일러의 오류는 Topaz 진단을 대신하지 않고 부가 정보로만 표시됩니다. 실패한 검사·실행·빌드는 0이 아닌 종료 코드를 반환합니다.
명령 예시
topaz check --root . src/main.tpz
topaz check --format json src/main.tpz
topaz explain TPZ5021 --json
topaz test --root . src/main.tpz -- arg1