토파즈 시작하기

스튜디오 헤이즈 내부 개발자용 안내. 몇 분 만에 환경을 설정하고 첫 프로그램을 실행해보세요.

토파즈에 오신 것을 환영합니다! 이 가이드는 토파즈 환경 설정부터 첫 번째 프로그램 실행까지 가능한 한 빠르고 매끄럽게 안내합니다. 10분이면 충분합니다! 🚀

대상
스튜디오 헤이즈 내부 개발자를 위해 작성되었습니다. 일부 배포 경로는 내부 전용입니다.

v4

📦 설치

토파즈는 스튜디오 헤이즈 채널을 통해 배포됩니다. 아래 중 하나를 이용하세요:

  • Dev Portal: 스튜디오 헤이즈 SSO 로그인 → Tools → 토파즈 → Install
  • 내부 문서: 엔지니어링 위키의 “토파즈 워크스테이션 셋업” 가이드
  • 플랫폼 지원: 접근 권한이 없다면 플랫폼 티켓 큐로 요청

참고

  • 일반적으로 스튜디오 헤이즈 SSO/VPN이 필요합니다.
  • macOS, Linux, Windows 빌드는 내부 레지스트리에서 제공합니다.
  • 외부 패키지 매니저는 제공되지 않을 수 있습니다.

✅ 설치 확인

설치가 완료되었는지 확인해보세요:

topaz --version

토파즈 1.0.0 같은 버전 정보가 나오면 성공입니다! 🎉

🚀 첫 번째 프로그램

가장 간단한 토파즈 프로그램부터 시작해보겠습니다.

hello.tpz 파일을 만들고 다음 코드를 입력하세요:

// 첫 번째 Topaz 프로그램
let 인사말 = "안녕하세요, Topaz 세계!"
print(인사말)

프로그램을 실행해보세요:

topaz run hello.tpz

결과:

안녕하세요, Topaz 세계!

축하합니다! 🎉 첫 번째 토파즈 프로그램을 성공적으로 실행했습니다.

🎯 REPL로 즉시 실험하기

토파즈는 강력한 REPL(Read-Eval-Print Loop)을 제공합니다. 코드를 즉시 실행하고 결과를 확인할 수 있어 학습과 실험에 완벽합니다.

터미널에서 다음 명령어를 입력하세요:

topaz repl

REPL이 시작되면 다음과 같이 실험해보세요:

let 이름 = "개발자"
"개발자"

let 나이 = 25
25

"안녕하세요, {이름}님! 나이가 {나이}세이시군요!"
"안녕하세요, 개발자님! 나이가 25세이시군요!"

let 점수들 = [85, 92, 78, 96, 88]
[85, 92, 78, 96, 88]

점수들.map(x => x + 5)
[90, 97, 83, 101, 93]

REPL을 종료하려면 Ctrl+C 또는 .exit를 입력하세요.

🌟 더 흥미로운 예제

이제 토파즈의 매력을 보여주는 더 흥미로운 예제를 만들어봅시다.

fibonacci.tpz 파일을 만들어보세요:

// 피보나치 수열 계산기
function 피보나치(n: int) -> int {
    match n {
        case 0 => 0
        case 1 => 1
        case _ => 피보나치(n-1) + 피보나치(n-2)
    }
}

// 처음 10개 피보나치 수 출력
let 결과 = (0..<10).map(피보나치)
print("피보나치 수열 (처음 10개): {결과}")

// 웹 API에서 데이터 가져오기 예제
let 사용자데이터 = fetch("https://jsonplaceholder.typicode.com/users/1")
    |> json()
    |> (data => data.name)

print("API에서 가져온 사용자 이름: {사용자데이터}")

실행:

topaz run fibonacci.tpz

📚 다음 단계

훌륭합니다! 이제 토파즈의 기본을 마스터했습니다. 다음 단계로 나아가보세요:

🎯 핵심 개념 학습

🛠️ 실전 프로젝트

📖 완전한 레퍼런스

🎉 축하합니다!

이제 여러분은 토파즈 개발자입니다! 🚀

코드가 시가 되는 경험을 시작해보세요. 토파즈와 함께라면 복잡한 로직도 아름답고 읽기 쉬운 코드로 표현할 수 있습니다.

지원이 필요하면 엔지니어링 위키를 참고하거나 Platform Engineering 팀에 문의하세요.