[devel] I: git.altlinux.org: email notification howto

["Dmitry V. Levin" <ldv@altlinux.org>]

[-- Attachment #1: Type: text/plain, Size: 1897 bytes --]

Hi,

С помощью специального репозитория etc/packages.git можно настроить
рассылку email-уведомлений об изменениях в git-репозиториях.

Рассылка уведомлений может быть двух типов:
1. По инициативе подписчиков, которые выбирают, какие уведомления им
нужны.
2. По инициативе владельцев репозиториев, которые решают, куда рассылать
уведомления.

Для каждого из этих типов в etc/packages.git заведено по файлу
специального формата.

Файл для подписки на уведомления первого типа называется
email-subscription и состоит из строк вида
USER PACKAGE REFTYPE REFNAME
где
- USER: имя владельца репозитория (USER в git_USER);
- PACKAGE: имя репозитория (PACKAGE в /people/USER/packages/PACKAGE.git);
- REFTYPE: вид изменяемой ссылки (head, release, remote или tag);
- REFNAME: имя изменяемой ссылки (basename от refs/*/*).
Каждое из этих 4-ех полей может быть либо полным именем, либо символом
"*".

Файл для рассылки уведомлений второго типа называется email-distribution
и состоит из строк вида
PACKAGE REFTYPE REFNAME MAILTO
где
- PACKAGE: имя репозитория (PACKAGE в /people/USER/packages/PACKAGE.git);
- REFTYPE: вид изменяемой ссылки (head, release, remote или tag);
- REFNAME: имя изменяемой ссылки (basename от refs/*/*);
- MAILTO: разделённый запятыми список получателей (USER1,USER2).
Каждое из первых 3-ех полей может быть либо полным именем, либо символом
"*".
Способ указать в MAILTO вместо идентификаторов разработчиков произвольные
адреса пока не придуман.

Для того чтобы начать экспериментировать с email-файлами, нужно сделать
git-clone git.alt:etc/packages.git
Изменения этих файлов отслеживаются hooks/update'ом только если они
сделаны в refs/heads/master.

На мой взгляд, практический интерес представляет первый тип уведомлений.
Пока писем не очень много, я записал "* * * *" в свой email-subscription.

Продолжение следует...


-- 
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]