첫 프로그램

.tpz 파일 하나를 만들고 검사한 뒤 실행해 보세요. 이어서 오류 메시지가 가리키는 위치를 찾아 타입 오류를 고칩니다.

로컬 터미널과 텍스트 편집기를 준비하세요. 빈 작업 폴더를 열고 아래 파일들을 그곳에 저장하세요. 시작할 곳을 고르려면 학습 경로를 참고하세요.

토파즈 설치하기

환경에 맞는 설치 방법 하나를 고르세요.

macOS나 Linux에서는 다음 명령을 실행하세요.

BASH

curl -fsSL https://topaz.ooo/install.sh | sh

Windows에서는 PowerShell을 사용하세요.

POWERSHELL

irm https://topaz.ooo/install.ps1 | iex

Node가 이미 설치돼 있다면 npm으로 설치할 수 있습니다.

BASH

npm install -g topaz-lang

어느 방법이든 시스템에 맞는 압축 프로그램을 내려받습니다. 설치 도구는 내려받은 파일과 압축을 푼 프로그램을 릴리스와 함께 공개된 SHA-256 체크섬과 비교합니다. Linux x86_64에서는 내려받는 파일이 약 33~47MB이고 설치된 topaz 프로그램은 122MB입니다.

설치 후 새 터미널을 열고 토파즈 명령을 찾을 수 있는지 확인하세요.

BASH

topaz version

출력

Topaz 5.20.4

출력은 Topaz 다음에 설치한 버전 번호를 표시합니다. 현재 공개판은 위 한 줄을 출력합니다. 명령을 찾지 못하면 터미널을 다시 열고 설치 폴더가 PATH에 있는지 확인하세요.

설치한 토파즈 명령으로 이 파일을 검사하고 실행할 수 있습니다. 네이티브 빌드에는 대상 플랫폼용 Cargo가 포함된 Rust 도구도 필요합니다. 이 도구는 첫 애플리케이션에서 사용합니다.

학습 계획 작성하고 실행하기

작업 폴더에 first-program.tpz를 만들고 아래 코드를 저장하세요.

TOPAZ

let 주제 = "Topaz basics"
let 분: int = 25
print("{주제}: {분} minutes")

그 폴더에서 파일을 검사한 뒤 실행하세요.

BASH

topaz check first-program.tpz
topaz run first-program.tpz

check는 파일을 실행하지 않고 타입과 이름 검사 결과를 보여 줍니다.

출력

first-program.tpz: types-ok (1 module)
first-program.tpz: resolve-ok (1 module)

run은 파일을 검사한 뒤 다음 결과를 출력합니다.

출력

Topaz basics: 25 minutes

첫 번째 let은 문자열에 이름을 붙이므로 검사기가 타입을 알아냅니다. 두 번째 줄은 분의 타입을 정수인 int로 정합니다. print는 {...} 안의 값을 넣어 출력합니다.

오류를 읽고 고치기

두 번째 파일 first-program-error.tpz를 만들고 일부러 타입을 틀린 아래 코드를 저장하세요.

let 주제 = "Topaz basics"
let 분: int = "25"
print("{주제}: {분} minutes")

두 번째 파일을 검사하세요.

BASH

topaz check first-program-error.tpz

검사기는 오류를 알리고 종료합니다. 기대한 타입과 실제 타입, 고칠 위치를 보여 줍니다.

출력

error[TPZ5001]: expected `int`, found `string`
 --> first-program-error.tpz:2:14
  |
2 | let 분: int = "25"
  |              ^^^^

first-program-error.tpz: 1 type diagnostic

first-program-error.tpz에서 표시된 "25"를 25로 고치세요. 따옴표 때문에 문자열이었던 값이 정수가 됩니다. 이제 topaz check first-program-error.tpz는 성공하고, topaz run first-program-error.tpz는 Topaz basics: 25 minutes를 출력합니다.

check와 run 고르기

편집 중에 프로그램을 실행하지 않고 타입과 이름 오류를 찾으려면 topaz check를 쓰세요. 같은 검사를 거친 뒤 실제 동작을 보려면 topaz run을 쓰세요. 프로그램 논리가 맞는지는 출력 결과를 테스트해서 확인합니다.

직접 해보기

주제를 "Functions"로, 분을 30으로 바꾸세요. 무엇을 출력할까요?

정답 보기

Functions: 30 minutes를 출력합니다. 값의 타입이 여전히 string과 int이므로 검사도 통과합니다.

편집기 설정하기

VS Code나 Open VSX 호환 편집기에서는 Visual Studio Marketplace 또는 Open VSX Registry에서 공식 토파즈 확장을 설치하세요. 확장은 .tpz 파일을 인식하고 토파즈 아이콘과 구문 강조를 제공합니다.

확장은 설치된 topaz lsp를 실행해 편집기에 오류 메시지를 보여 줍니다. 컴파일러는 별도로 설치합니다. 편집기가 PATH에서 컴파일러를 찾을 수 있게 하거나 topaz.executablePath에 경로를 지정하세요. 터미널에서 topaz check를 써도 됩니다.

프로그램이 동작하면 다음으로

고친 파일이 topaz check를 통과하고 topaz run으로 예상한 한 줄을 출력하면 준비가 됐습니다.

값과 함수로 이어가세요. 문법을 찾을 때는 문법 한눈에 보기를 곁에 두세요.