Язык, где код становится поэзией

Добро пожаловать в Топаз! Это руководство проведёт вас от настройки среды Топаза до запуска первой программы как можно быстрее и плавнее. Вам понадобится всего 10 минут! 🚀

Аудитория
Руководство рассчитано на инженеров Studio Haze. Часть каналов распространения — внутренние.

📦 Установка

Топаз распространяется через каналы Studio Haze. Используйте один из вариантов:

Портал разработчика: войдите через SSO Studio Haze → Инструменты → Топаз → Установить
Внутренняя документация: следуйте руководству «Настройка рабочей станции Топаза» на инженерной вики
Поддержка платформы: если доступа ещё нет, создайте заявку в очереди платформенной команды

Примечания

Обычно требуется доступ по SSO/VPN Studio Haze.
Сборки для macOS, Linux и Windows доступны из внутреннего реестра.
Внешние менеджеры пакетов могут быть недоступны.

✅ Проверка установки

Проверьте, прошла ли установка успешно:

topaz --version

Если команда выводит информацию о версии, всё готово! 🎉

🚀 Ваша первая программа

Начнём с самой простой программы на Топазе.

Создайте файл привет.tpz и введите следующий код:

// Ваша первая программа на Топазе
let приветствие = "Привет, мир Топаза!"
print(приветствие)

Запустите программу:

topaz run привет.tpz

Результат:

Привет, мир Топаза!

Поздравляем! 🎉 Вы успешно запустили свою первую программу на Топазе.

🎯 Эксперименты с REPL

Топаз предоставляет мощный REPL (чтение–вычисление–вывод). Вы можете мгновенно выполнять код и видеть результаты, что делает его идеальным для обучения и экспериментов.

Введите эту команду в терминале:

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.

🌟 Более интересные примеры

Теперь давайте создадим более интересные примеры, которые показывают очарование Топаз.

Создайте файл фибоначчи.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()
    |> (данные => данные.name)

print("Имя пользователя из API: {данныеПользователя}")

Запустите:

topaz run фибоначчи.tpz

📚 Следующие шаги

Отлично! Теперь вы освоили основы Топаза. Переходите к следующим шагам:

🎯 Изучите основные концепции

Основы синтаксиса - Базовый синтаксис языка Топаза
Типы данных - Строки, числа, массивы, объекты и т.д.
Функции и замыкания - Основа функционального программирования

🛠️ Создавайте реальные проекты

Первый проект - Создание реальных приложений
Использование веб-API - Обработка и преобразование данных
Понимание рекурсии - Продвинутые паттерны программирования

📖 Полный справочник

Основные функции - Полное руководство по встроенным функциям
Функциональная библиотека - map, filter, reduce и т.д.
Операторы - Справочник всех операторов

🎉 Поздравляем!

Теперь вы разработчик на Топазе! 🚀

Начните своё путешествие, где программирование становится поэзией. С Топазом даже сложную логику можно выразить как красивый, читаемый код.

За помощью обратитесь к внутренней инженерной вики или к платформенной команде.