Alt-tasks
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 p9, /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
.