@343dev/harold

alt="Аватар: грустный эмоджи в маске с улыбкой"
src="./logo.png">


Harold — CLI-утилита для сравнения размеров сборок фронтенд-проекта.

Мотивация

Размер бандла среднестатистического фронтенд-проекта растёт с каждым изменением.

Чтобы ~~прочувствовать боль~~ облегчить сравнение размеров до и после рефакторинга, обновления зависимостей
или каких-то масштабных правок, мы создали Гарольда.

Демо

alt="Демо GIF"
src="./demo.gif">

Демо ускорено в несколько десятков раз. В реальной жизни установка зависимостей и сборка проекта занимают
примерно вечность.

Установка

``bash
npm install -g @343dev/harold
`

Команды

$3

Собирает проект, и создаёт слепок сборки.

Доступные флаги:

- -c, --config — указывает путь до файла конфигурации, переопределяет конфиг по умолчанию;
- -o, --output — указывает путь, по которому нужно сохранить слепок; по умолчанию harold_snapshot__.json;
- -e, --exec — указывает команду для сборки проекта; по умолчанию npm run build-production;
- -p, --path — указывает путь до результирующей директории сборки, слепок которой будет сделан; по умолчанию public.

$3

Сравнивает указанные слепки.

$3

Выводит справку по командам.

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

Настройки по умолчанию расположены в .haroldrc.js, файл содержит список поддерживаемых
параметров и их краткое описание.

При запуске с флагом --config path/to/.haroldrc.js будут использоваться настройки из указанного конфигурационного файла.

При обычном запуске, без флага --config, будет произведён рекурсивный поиск файла .haroldrc.js начиная
с текущей директории и до корня файловой системы. Если файл не найден, то будут применены настройки по умолчанию.

FAQ

$3

При вызове harold snapshot Гарольд запускает сборку проекта, ждёт пока она закончится, после этого идёт в папку
с файлами бандла и записывает размер каждого из них. По пути он ещё и создаёт gzip-версию каждого файла, и записывает
и его размер. После этого собирает всё это в кучу и сохраняет в JSON-файл.

При вызове harold diff first.json second.json он сравнивает переданные JSON-файлы и выводит общую статистику.

$3

Современные бандлеры умеют добавлять в имена файлов хэши, чтобы улучшать их кэширование. Однако, Гарольд сравнивает
файлы основываясь на их имени. Чтобы улучшить качество пофайлового сравнения, стоит настроить бандлер таким образом,
чтобы он отключал добавление хэшей, если указана переменная окружения, например NO_HASH.

$3

Передайте в --exec какую-нибудь бесполезную команду, вроде echo`.

Благодарности

Аватар для репозитория нарисовал Игорь Гарибальди.