Учебный маршрут

Результат: вы выберете подходящую среду и увидите весь путь от одного файла .tpz до протестированного продукта из двух модулей.

Что понадобится: текстовый редактор и базовые навыки работы в терминале; для последнего занятия также нужен Python 3.11 или новее.

Выберите, где начать

Откройте Playground, если хотите изменить и запустить короткую программу без установки. В браузере можно пройти первые четыре занятия о языке, но нельзя создать пакет и артефакт из финального шага.

Установите Топаз локально, если хотите пройти маршрут полностью. В разделе Первая программа есть варианты для shell, 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-хостинг и внутреннее устройство backend остаются возможными следующими темами, а не условиями входа.

Выбор: Playground или локальные инструменты?

Выберите Playground, если сейчас вы спрашиваете: «Что вычисляет это выражение?» Локальная установка нужна для другой цели: «Могу ли я закончить протестированное приложение и сохранить его артефакт?» Можно начать в браузере и перейти в терминал перед последним занятием — знания при этом не теряются.

Попробуйте

Решите, где вы будете проходить курс. Нужна ли локальная установка прямо сейчас?

Готовы двигаться дальше, если

Вы выбрали среду, понимаете, что итогом станет протестированный двухмодульный продукт на Python, и уже открыли Playground либо готовы установить topaz.

Переходите к Первой программе. Держите рядом ненумерованный справочник Краткий обзор синтаксиса, если понадобится быстро вспомнить форму записи.