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

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

Что такое Razd?

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

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

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

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

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

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

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

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

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

Какие платформы поддерживает 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?

Razd поддерживает два провайдера: mise и devbox. По умолчанию используется mise.

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

version: "1"

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

Или использовать devbox вместо mise:

version: "1"

dependencies:
  using: "devbox"
  ensure:
    - "nodejs@22"

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

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

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

Клонирование (если указан URL) — git clone [URL]
Чтение конфигурации — Razdfile.yml или mise.toml + Taskfile.yml
Синхронизация конфигурации — Razdfile.yml ↔ mise.toml
Установка инструментов — mise install (Node.js, Python...)
Выполнение default задачи — установка зависимостей, настройка БД, первичная сборка, запуск dev сервера
Проект готов!

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

Команда	Описание	Пример
`razd up`	Установить зависимости и настроить проект	`razd up`
`razd up -r`	Установить и запустить default задачу	`razd up -r`
`razd init`	Создать Razdfile.yml	`razd init`
`razd init --using devbox`	Создать Razdfile с devbox провайдером	`razd init --using devbox`
`razd add <tool@version>`	Добавить зависимость	`razd add node@22`
`razd list`	Показать доступные задачи	`razd list`
`razd list --all`	Показать все задачи включая внутренние	`razd list --all`
`razd list --json`	Список задач в формате JSON	`razd list --json`
`razd run <task>`	Выполнить задачу	`razd run test`
`razd dev`	Запустить dev сервер (задача dev)	`razd dev`
`razd build`	Собрать проект (задача build)	`razd build`
`razd shell`	Запустить оболочку с окружением	`razd shell`
`razd trust`	Доверять проект	`razd trust`
`razd --version`	Показать версию	`razd --version`
`razd --help`	Показать справку	`razd --help`

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

razd up --no-sync

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

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

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

cd my-project
razd init                    # Создать с mise (по умолчанию)
razd init --using devbox     # Создать с devbox

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

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

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

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

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

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

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

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

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

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

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

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

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