Перейти к содержанию
zoryn/ maintainer-assistant

Хуки

zoryn выполняет shell-скрипты из двух каталогов во время zoryn up:

КаталогКогда выполняется
.gear/merge-up.d/После merge с upstream-тэгом, до обновления spec
.gear/up.d/После обновления spec, до коммита

Скрипты выполняются в лексикографическом порядке. Должны быть исполняемыми (chmod +x).

.gear/merge-up.d/

Скрипты выполняются после merge upstream-тэга, но до обновления spec. Полезно для регенерации vendored-зависимостей, которые должны соответствовать новой версии.

Интерфейс:

$1            — версия (очищенный тэг)
$TAG          — полное имя тэга
$COMMIT       — SHA1 коммита
$SHORTCOMMIT  — короткий SHA1

Пример .gear/merge-up.d/01-vendor.sh:

#!/bin/bash
go mod vendor

.gear/up.d/

Скрипты выполняются после обновления spec-файла, до коммита. Полезно для синхронизации сопутствующих файлов с версией.

Интерфейс:

$1 — новая версия

Пример .gear/up.d/10-version.sh:

#!/bin/bash
sed -i "s/VERSION=.*/VERSION=$1/" configure.ac

Песочница

По умолчанию хуки запускаются в hybrid-песочнице (bubblewrap + chroot hasher), чтобы вредоносный или ошибочный хук не мог прочитать ~/.ssh или ~/.gnupg. См. Песочницу о трёх режимах и том, как выбрать подходящий.

Подсветка синтаксиса

zoryn подсвечивает вывод логов с помощью формата sublime-syntax. Встроенный log.sublime-syntax (из bat) распознаёт уровни, даты, время, IP-адреса, URL, строки в кавычках, числа и key=value.

Цветовые темы — формат .tmTheme (совместим с TextMate/Sublime Text). Тема по умолчанию — Monokai.

Пользовательские файлы перекрывают встроенные:

ФайлНазначение
~/.config/zoryn/syntaxes/*.sublime-syntaxСвои синтаксисы
~/.config/zoryn/theme.tmThemeСвоя цветовая тема

Подсветка работает в:

Автоматически отключается, если вывод не в TTY или установлена переменная NO_COLOR.

Окружение

SSH-алиасы в ~/.ssh/config (создаются командой zoryn gen environment):

Host gitery
    HostName gitery.altlinux.org
    Port 222
    User alt_username

Host gyle
    HostName gyle.altlinux.org
    Port 222
    User alt_username