Topaz는 하나의 해석된 프로그램을 해석기와 여러 백엔드가 함께 사용하는 도구 모음입니다. 구문 분석, 모듈 해석, 정적 검사를 공통 입구로 사용합니다.
기본 규칙
드라이버에는 파서와 진단, 모듈 해석기, 타입 검사기, 기준 해석기, Rust·Python·웹 백엔드, 포매터, LSP, 패키지 해석기, 문서 생성기, 마이그레이션 도구가 포함됩니다. 백엔드는 내부 표현을 자유롭게 선택할 수 있지만 사용자가 관찰하는 결과는 같아야 합니다.
사용 방법
check는 실행 없이 전체 파일 또는 패키지를 검사합니다. run은 해석기로 실행하고, test는 격리된 테스트 호스트를 사용하며, build는 배포할 산출물을 만듭니다. emit은 검토용 Rust 소스를 보여 줍니다. 진입 파일을 생략하고 --root에 topaz.toml이 있으면 패키지 모드로 동작합니다.
현재 지원
해석기, Rust, Python, 패키지, Web과 제한형 HTTP 서비스 산출물은 같은 검사된 프로그램을 입력으로 사용합니다. 정확한 설치 식별자가 필요할 때는 topaz version --verbose를 사용하세요.
제한 사항
네이티브 build는 사용자의 Rust 도구를 호출하지만 run, check, emit은 Rust 설치가 필요하지 않습니다. 웹 대상과 컴파일러 플레이그라운드는 서로 다른 산출물입니다. --unchecked는 컴파일러 조사용 우회 경로이므로 일반 프로그램 빌드에 사용하면 안 됩니다.
명령 예시
topaz check main.tpz
topaz run main.tpz
topaz build main.tpz --out-dir build
topaz version --verbose