학습 경로

학습 결과: 하나의 .tpz 파일에서 테스트된 두 모듈 제품까지 이어지는 정확한 경로를 이해하고, 자신에게 맞는 시작 환경을 고릅니다.

준비물: 텍스트 편집기와 기초적인 터미널 사용법만 알면 시작할 수 있으며, 마지막 실습에는 Python 3.11 이상도 필요합니다.

시작 환경 고르기

설치 없이 짧은 프로그램을 고쳐 실행해 보고 싶다면 Playground를 사용하세요. 앞쪽의 언어 실습 네 개는 이곳에서도 따라갈 수 있지만, 마지막에 사용할 패키지와 산출물은 만들 수 없습니다.

전체 경로를 완주하려면 토파즈를 로컬에 설치하세요. 첫 프로그램에서 셸, PowerShell, npm 설치 방법을 안내하며, 어느 운영 체제에서든 같은 topaz 명령을 사용합니다.

실습 다섯 개는 보통 한 시간 안팎이면 마칠 수 있습니다. 각 페이지의 준비 확인에서 멈췄다가 나중에 이어도 됩니다. 실습을 하나 끝낼 때마다 학습 계획 프로그램은 다시 실행 가능한 상태가 됩니다.

완성할 프로그램

실습마다 주제를 바꾸지 않고 같은 예제를 조금씩 키웁니다.

1. 첫 프로그램 — 학습 계획 값을 작성하고 check와 run을 실행한 뒤 정적 타입 진단 하나를 고칩니다.
2. 값과 함수 — 추론한 타입과 적어 둔 타입, 함수, 그리고 실제로 상태 변화가 필요한 값 하나를 추가합니다.
3. 데이터와 제어 — 학습 작업을 명목 데이터로 표현하고 컬렉션에 담은 뒤 if, match, for를 사용합니다.
4. 실패와 리소스 — 잘못된 입력을 Option, Result, ?로 다루고, defer로 정리를 보장하며, 의도적인 fault 하나를 살펴봅니다.
5. 첫 애플리케이션 — 코드를 src/main.tpz와 src/plan.tpz로 나누고 테스트를 더한 뒤, 잠그고 검사한 패키지에서 Python 제품을 빌드합니다.

마지막에는 .tpz 파일이 하나도 없는 별도 디렉터리에서, 토파즈 프로젝트와 컴파일러 없이 생성된 제품을 실행합니다. 패키지 레지스트리, 브라우저 생명주기, HTTP 호스팅, 백엔드 내부 구조는 입문 과정의 필수 조건이 아니라 이후에 선택할 주제입니다.

선택: Playground인가, 로컬 도구인가?

지금 궁금한 것이 “이 식을 실행하면 무엇이 나올까?”라면 Playground를 고르세요. 목표가 “테스트된 애플리케이션과 보관할 산출물까지 완성할 수 있을까?”라면 로컬 설치가 알맞습니다. 브라우저에서 시작해 마지막 실습 전에 로컬로 옮겨도 학습 흐름은 끊기지 않습니다.

직접 해보기

이 과정을 어디에서 진행할지 정해 보세요. 지금 바로 로컬 설치가 필요할까요?

다음 단계로 넘어갈 준비

시작 환경을 고를 수 있고, 마지막 결과물이 테스트된 두 모듈 Python 제품이라는 점을 이해했으며, Playground를 열었거나 topaz를 설치할 준비가 되었다면 충분합니다.

첫 프로그램으로 계속하세요. 형식이 기억나지 않을 때는 번호가 없는 참고 페이지인 문법 한눈에 보기를 곁에 열어 두면 됩니다.