mg — инструмент командной строки Mercury на Go. В этом курсе вы сначала получите рабочую справку, затем обновите примеры компонентов и проверите их без записи файлов. В каждой главе указаны ожидаемый результат и действия при ошибке.
Выберите инструмент
mx устанавливает зависимости Mercury, запускает сервер приложения, собирает приложение и выполняет тесты. mg выполняет описанную здесь генерацию исходных файлов. Это разные исполняемые файлы с отдельной справкой. Установка mx сама по себе не означает, что mg тоже установлен.
| Задача | С чего начать |
|---|---|
| Запустить, собрать или проверить приложение | Курс mx |
| Узнать доступные команды mg | mg help |
| Обновить примеры обозревателя компонентов | mg gen examples |
| Проверить результат без записи файлов | mg gen examples --check |
| Прочитать результат из программы | --json, при необходимости с --agent |
Запустите из исходников
Для этого курса нужны рабочая копия jonnify и Go 1.26.0 или новее в PATH. Из корня репозитория выполните:
scripts/mg help
alias mg="$PWD/scripts/mg"
mg version
Скрипт собирает bin/mg и запускает его в текущем каталоге. При первой сборке Go может загрузить зависимости модуля. Собранной программе не нужны Node, Python и cgo. Первая глава объясняет запуск, совпадение имени с редактором macOS и дополнение команд.
Главы курса
- Первые команды: запустите нужную программу, прочитайте справку, определите сборку и включите дополнение.
- Генерация примеров: создайте каталог обозревателя из историй UI, просмотрите изменения и проверьте расхождения.
- Автоматизация и ошибки: используйте JSON и подсказки агенту, различайте ошибки и сохраняйте код завершения.
Границы курса
Курс использует запуск из исходников; готовый опубликованный архив mg или установщик npm здесь не предоставляется. Для главы о генерации нужна сборка, в которой mg help gen examples показывает --check и --root. Если справка содержит только help, version и completion, доступны первая и третья главы; для генерации потребуется соответствующее обновление исходников.
Создание каркаса приложения и преобразование кода не входят в описанный набор команд. Доступные возможности определяет справка вашей программы. Успешная проверка генерации означает, что ожидаемые файлы соответствуют исходникам; поведение примеров в браузере проверяют отдельно.