Часто задаваемые вопросы

Общие вопросы

Что такое Razd?

Razd (от русского "разд/раздуплиться" — проснуться и взять себя в руки) — это современный CLI инструмент на Rust, который автоматизирует полный цикл настройки проекта. Он оркестрирует работу git, mise и taskfile, превращая многошаговый процесс клонирования, установки инструментов и настройки зависимостей в одну команду razd up.

Ключевая идея: Вместо запоминания и выполнения десятка команд для каждого нового проекта, вы выполняете одну — и проект готов к работе.

Чем Razd отличается от других инструментов настройки?

Razd уникален по нескольким причинам:

1. Интеграция вместо замены — использует проверенные инструменты экосистемы (mise, taskfile) вместо изобретения собственных
2. Нулевая конфигурация — работает с существующими .mise.toml и Taskfile.yml без изменений
3. Истинная кроссплатформенность — одинаковое поведение на Windows, macOS и Linux

В чем разница между Razdfile.yml, mise.toml и Taskfile.yml?

• Razdfile.yml — унифицированная конфигурация Razd, объединяющая управление инструментами (mise) и задачи (taskfile) в одном файле
• .mise.toml (или mise.toml) — конфигурация mise для управления версиями инструментов
• Taskfile.yml — конфигурация taskfile для определения задач автоматизации (он создается по вашему желанию, если имеете понимание, как с ним работать)

Razd автоматически синхронизирует Razdfile.yml ↔ .mise.toml для согласованности.

Установка и настройка

Какие платформы поддерживает Razd?

Razd работает на всех основных платформах:

Платформа	Архитектура	Статус
Windows	x64	✅ Полная поддержка
Linux	x64	✅ Полная поддержка
macOS	Intel (x86_64)	⚠️ Не тестировалось, но возможно работает
macOS	Apple Silicon (ARM64)	⚠️ Не тестировалось, но возможно работает

Терминалы:

• Windows: PowerShell, Command Prompt, Git Bash, WSL
• macOS/Linux: bash, zsh, fish, и другие POSIX-совместимые

Нужно ли устанавливать mise и task отдельно?

mise — да, обязательно. Это ключевая зависимость.

task — нет, опционально. Razd автоматически установит task через mise при первой необходимости.

Установка mise:

# Unix/Linux/macOS
curl https://mise.run | sh

# macOS (Homebrew)
brew install mise

# Windows
winget install jdx.mise

Можно ли использовать Razd без mise?

В настоящее время нет. mise — обязательная зависимость, так как Razd использует его для:

• Управления версиями инструментов разработки
• Обеспечения изоляции проектов
• Установки более 500 инструментов экосистемы

Однако, если ваш проект не требует специальных инструментов, можете использовать только задачи:

tasks:
  default:
    cmds:
      - echo "Hello from Razd!"

Вопросы по использованию

Что происходит, когда я запускаю razd up?

razd up выполняет полный цикл настройки:

razd up [URL]
    ↓
┌─────────────────────────────────────┐
│ 1. Клонирование (если указан URL)  │
│    git clone [URL]                  │
└─────────────────────────────────────┘
    ↓
┌─────────────────────────────────────┐
│ 2. Чтение конфигурации              │
│    Razdfile.yml или                 │
│    mise.toml + Taskfile.yml         │
└─────────────────────────────────────┘
    ↓
┌─────────────────────────────────────┐
│ 3. Синхронизация конфигурации       │
│    Razdfile.yml ↔ mise.toml         │
└─────────────────────────────────────┘
    ↓
┌─────────────────────────────────────┐
│ 4. Установка инструментов           │
│    mise install (Node.js, Python...)│
└─────────────────────────────────────┘
    ↓
┌─────────────────────────────────────┐
│ 5. Выполнение default задачи        │
│    - Установка зависимостей         │
│    - Настройка БД                   │
│    - Первичная сборка               │
│    - Запуск dev сервера             │
└─────────────────────────────────────┘
    ↓
    ✅ Проект готов!

Какие команды доступны в Razd?

Команда	Описание	Пример
razd up [URL]	Клонировать и настроить проект (или настроить локальный)	razd up https://github.com/user/repo
razd up --init	Создать Razdfile.yml с автоопределением типа проекта	razd up --init
razd install	Установить инструменты из Razdfile.yml	razd install
razd setup	Установить зависимости проекта	razd setup
razd dev	Запустить dev сервер	razd dev
razd build	Собрать проект	razd build
razd run <task>	Выполнить кастомную задачу	razd run test
razd --version	Показать версию	razd --version
razd --help	Показать справку	razd --help

Как отключить автоматическую синхронизацию?

Для одной команды:

razd install --no-sync
razd up --no-sync

Конфигурация

Как создать Razdfile.yml с нуля?

Автоматически (рекомендуется):

cd my-project
razd up --init

Какие инструменты поддерживает mise?

Многие стеки технологий! Включая:

Языки программирования:

• JavaScript/TypeScript: node, deno, bun
• Python: python, poetry, pipenv
• Rust: rust, cargo
• PHP: php, composer
• Java: java, maven, gradle
• И многие другие

Подробнее: mise plugins

Производительность и лучшие практики

Насколько быстр Razd?

Razd разработан для скорости:

• Написан на Rust для производительности

Получение помощи

Где можно получить поддержку?

• Документация: Этот сайт охватывает большинство распространённых сценариев
• GitHub Issues: Сообщить об ошибках или запросить функции
• Telegram Chat: Присоединиться к чату

Как сообщить об ошибке?

Пожалуйста, включите:

1. Вашу операционную систему и версию
2. Версию Razd (razd --version)
3. Полное сообщение об ошибке
4. Шаги для воспроизведения
5. Ожидаемое vs фактическое поведение

Как я могу внести вклад?

Мы приветствуем вклады:

• Документация: Улучшите эту документацию
• Сообщения об ошибках: Помогите нам найти и исправить проблемы
• Запросы функций: Предложите улучшения
• Код: Отправьте pull request
• Примеры: Поделитесь настройками ваших проектов

Проверьте репозиторий GitHub для более подробной информации о вкладе.