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

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

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

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

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

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

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

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

Попробуйте

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

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

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

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