Alt-tasks

Материал из ALT Linux Wiki

alt-tasks — консольная программа, предназначенная для поиска заданий по сборке пакетов и дальнейшему выводу информации по найденным заданиям. Поиск осуществляется по критериям, задаваемым аргументами команды запуска программы.

Написана на Go. Распространяется по лицензии GPLv3.0.

Использование

Для вывода доступных параметров следует вызвать справку, запустив приложение без параметров или с параметром --help.

Выборка запрашиваемой информации осуществляется по данным, получаемым из d-t-s-evr.list файлов, поиск которых осуществляется в каталогах, которые должны быть указаны пользователем в файле ~/.alt-task/src_list в следующем формате:

<условное название данной цели>, <абсолютный путь в файловой системе>

Так, например, при работе на сервере ALT Linux Team, данный файл мог бы иметь следующий вид:

sisyphus, /ALT/repo/sisyphus/index/src
p9, /ALT/repo/p9/index/src
p8, /ALT/repo/p8/index/src

Пример команды поиска заданий в репозиторий sisyphus, прошедших commit после 26 сентября 2017 года, но до 1 января 2020 года (при этом считается, что содержимое файла src_list соответствует указанному выше):

alt-tasks --target sisyphus --after 2017-09-26 --before 2020-01-01

По завершению работы программы в домашнем каталоге может быть создан двоичный файл ~/.alt-task/<target>.dmp, содержащий собранную информацию по всем заданиям репозитория, исследованного при данном запуске (далее "бинарные копии"). Бинарные копии будут использоваться при последующих запусках с тем же значением параметра --target, если после создания данного файла прошло менее одного часа (бинарные копии, с момента создания которых прошло больше времени, будут удалены), время выполнения программы при этом уменьшается крайне существенно. Пользователь может запретить использовать существующие бинарные копии, запустив приложение с флагом --update (например, если возможно изменение репозитория в интервале времени, меньшем чем срок годности бинарных копий):

alt-tasks --target p9 --after 2020-01-01 --update

Пользователь может запретить создавать бинарные копии, запустив приложение с флагом --notrace:

alt-tasks --target p9 --after 2020-01-01 --notrace

Программа поддерживает возможность задания произвольного формата вывода. Доступны следующие преобразования:

%d Дата и время commit-а задания
%t Номер задания
%s Номер подзадания
%n Название пакета
%v Версия пакета (epoch:version-release)
%h Хэш-сумма commit-a задания

Так, например, для вывода номеров заданий и соответствующих им названий и версий пакетов с запятыми в качестве разделителей, следует задать:

alt-tasks <прочие параметры> --format "%t,%n,%v"

Для активации подробного вывода (сообщений о выполняемых операциях и статусе завершения этих операций) следует использовать флаг --verbose.

Ссылки

Проект на git.altlinux.org