vyatka-it / grievous-installer

dev-main 2026-10-19 13:02 UTC

Requires

• php: ^8.2
• laravel/prompts: ^0.3
• symfony/console: ^7.0 || ^8.0
• symfony/dependency-injection: ^7.0 || ^8.0

Requires (Dev)

• pestphp/pest: ^3.8

proprietary

Published on Packagist.org on 2026-10-19 13:29 UTC

README

Глобальная CLI-утилита для создания модулей Grievous и в будущем Laravel-проектов с предустановленным Grievous.

Установка

Сначала добавьте глобальную директорию Composer bin в PATH, чтобы оболочка сразу находила установленные команды. Для macOS с zsh:

COMPOSER_BIN_DIR="$(composer global config bin-dir --absolute)"
grep -Fq "$COMPOSER_BIN_DIR" ~/.zshrc || echo "export PATH=\"$COMPOSER_BIN_DIR:\$PATH\"" >> ~/.zshrc
source ~/.zshrc

Затем установите пакет из Packagist. Пока опубликована только ветка dev-main, поэтому укажите её явно:

composer global require vyatka-it/grievous-installer:dev-main

Откройте новый терминал или выполните source ~/.zshrc, если текущая сессия не подхватила обновлённый PATH.

Создание модуля

grievous new module billing
grievous new module billing --dir=./modules

В интерактивном терминале команда открывает пошаговую форму на Laravel Prompts: имя модуля, namespace, Service Provider, начальный статус и файлы для module.json. Поля имеют подсказки и значения по умолчанию; к предыдущим вопросам можно вернуться сочетанием Ctrl+U. Имя можно передать сразу в команде или заполнить в форме. Каталог получает имя из названия модуля (billing превращается в Billing). Без --dir родительским каталогом будет текущая директория терминала.

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

В планах

grievous new project shop

Эта команда будет создавать Laravel-приложение и устанавливать/настраивать в нём Grievous.