토파즈 도구 모음은 파일과 패키지를 소스에서 실행 가능한 제품까지 하나의 검사된 경로로 처리합니다. 파서나 백엔드 내부를 알아야 사용할 수 있는 도구가 아닙니다.
일반적인 작업 순서
명령은 다음 순서로 사용합니다.
fmt --check로 커밋할 소스가 정본 서식인지 확인합니다.check로 프로그램을 실행하지 않고 모듈을 해석하며 문법, 이름, 타입 진단을 확인합니다.test로 검사된 테스트 진입점을 결정적인 테스트 호스트에서 실행합니다.run으로 명령형 애플리케이션을 인터프리터에서 직접 실행합니다.build로 실제 배포할 제품 대상 하나를 만듭니다.
잠긴 패키지의 전체 명령 형태는 다음과 같습니다.
topaz fmt --check --root my-app
topaz check --root my-app --locked
topaz test --root my-app --locked
topaz run --root my-app --locked
topaz build --root my-app --locked --out-dir product
Web 애플리케이션과 HTTP 패키지는 topaz run 대신 topaz dev로 루프백 개발
동작을 확인한 뒤 같은 패키지 모드 build를 사용합니다.
편집기 지원
공식 토파즈 확장은 Visual Studio Marketplace와 Open VSX Registry에서 모두 제공됩니다. VS Code에서는 Marketplace 등록본을, VSCodium이나 다른 호환 편집기에서는 Open VSX 등록본을 사용하세요.
두 스토어는 같은 선언형 TextMate 확장을 제공합니다. .tpz 파일 인식, 토파즈
파일 아이콘, 키워드·템플릿 태그·문자열 보간·유니코드 식별자·연산자·숫자·타입
구문 강조가 포함됩니다. 컴파일러 실행, 자동완성, 진단 기능은 포함하지 않으므로
정확한 검사 결과는 topaz check로 확인하세요.
성공했을 때 달라지는 것
fmt --check, check, test, run은 배포 제품을 만들지 않습니다. build는
관리되는 대상 디렉터리를 쓰고 파일 목록을 topaz-artifact.json에 기록합니다.
패키지 명령은 topaz.toml을 읽으며, --locked를 사용하면 topaz.lock이
매니페스트와 로컬 의존성 바이트에 맞아야 합니다.
0이 아닌 종료 코드는 요청한 단계가 완료되지 않았다는 뜻입니다. 첫 토파즈 진단을 고치고 그 단계부터 반복하세요. 외부 컴파일러가 없다면 준비된 대상을 선택하거나 필요한 도구 모음을 설치합니다. 관리형 출력 디렉터리가 달라졌다면 기존 내용을 보존하고 새 빈 디렉터리를 사용하세요.
작업에 맞는 다음 문서
- 명령 옵션, 진단, 종료 동작과 복구는 CLI와 진단을 봅니다.
- 패키지 루트, 잠금 파일, 로컬 의존성과 벤더링은 패키지와 배포를 봅니다.
- 네이티브, Python, Web, HTTP 제품 내용과 토파즈 패키지 소스 없는 실행은 산출물과 배포를 봅니다.
- 인터프리터와 빌드 대상 중 무엇을 고를지는 인터프리터와 백엔드를 봅니다.