토파즈 프로그램의 서식을 맞추고, 검사·테스트·실행·빌드할 명령을 고르세요. 파일 하나로 시작하거나 여러 파일과 의존성을 패키지로 묶어 작업할 수 있습니다.
첫 프로그램을 따라 topaz를 설치하세요. 아래 패키지 예제는 첫 애플리케이션에서 완성한 study-plan 프로젝트를 사용합니다.
파일과 패키지 명령 고르기
첫 프로그램의 first-program.tpz가 있는 폴더에서 다음 명령을 실행하세요.
topaz check first-program.tpz
topaz run first-program.tpz검사가 성공하면 종료 코드는 0입니다. 프로그램은 Topaz basics: 25 minutes를 출력합니다. 패키지로 작업할 때는 topaz.toml과 생성한 topaz.lock이 있는 study-plan 폴더에서 다음 명령을 실행하세요.
topaz fmt --check --root .
topaz check --root . --locked
topaz test tests/plan.tpz --root . --locked
topaz run --root . --locked
topaz build --root . --locked --out-dir product| 명령 | 확인할 결과 |
|---|---|
fmt --check | 소스가 토파즈 서식을 따르면 종료 코드는 0입니다. 다른 파일이 나오면 topaz fmt --root .로 고친 뒤 다시 확인하세요. |
check | 구문·이름·import·타입 검사가 통과하면 종료 코드는 0입니다. 프로그램은 실행하지 않습니다. |
test tests/plan.tpz | 지정한 테스트 파일을 실행합니다. 성공하면 test-ok가 나옵니다. |
run | 학습 계획 프로그램은 tasks=2, remaining=25 minutes를 출력합니다. |
build | product/에 실행 파일과 생성 파일을 기록한 topaz-artifact.json을 만듭니다. |
패키지 명령에서 파일 인수를 생략하면 topaz.toml의 진입 파일을 사용합니다. 테스트할 파일은 경로를 지정하세요. --locked는 매니페스트와 로컬 의존성 내용을 topaz.lock과 대조합니다. 이 파일을 만들거나 갱신하는 방법은 패키지 안내를 보세요.
build는 배포할 파일을 만듭니다. 네이티브와 Web 빌드에는 대상에 맞는 Rust 툴체인이 필요합니다. 인터프리터와 백엔드에서 대상을 고른 뒤 아티팩트와 배포를 따라 진행하세요.
편집기에서 컴파일러 사용하기
기본 컴파일러인 self는 토파즈로 작성했으며 설치한 실행 파일에 들어 있습니다. Rust 참조 컴파일러와 동작을 비교하려면 --compiler rust를 선택하세요. 설치 정보는 툴체인 상태에서 확인할 수 있습니다.
VS Code에서는 Visual Studio Marketplace, VSCodium과 호환 편집기에서는 Open VSX Registry의 공식 확장을 설치하세요.
두 스토어는 같은 확장을 제공합니다. 확장은 .tpz 파일을 인식하고 파일 아이콘, 구문 강조, 주석·괄호 설정, 기본 스니펫을 제공합니다. 설치된 topaz lsp 서버를 실행해 컴파일러 진단도 보여 줍니다.
컴파일러는 별도로 설치하세요. 실행 파일이 없으면 편집기가 오류를 알리며, 구문 강조와 정적 편집 기능은 계속 사용할 수 있습니다. topaz가 PATH에 없다면 topaz.executablePath를 설정하세요.
오류를 고친 뒤 이어가기
명령이 0이 아닌 코드로 끝나면 첫 진단을 고치고 같은 명령을 다시 실행하세요. 옵션과 오류 코드는 CLI와 진단에서 설명합니다.
빌드가 Rust 툴체인을 찾지 못하면 선택한 대상용 툴체인을 설치하세요. 기존 출력 폴더의 파일이 달라졌다면 그 폴더를 보존하고 비어 있는 새 --out-dir을 고르세요.