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-а задания
	%u - Unix-время commit-а задания
	%t - Номер задания
	%s - Номер подзадания
	%n - Название пакета
	%v - Предыдущая и новая версии пакета
(epoch0:version0-release0 >> epoch:version-release), или только новая версия
(epoch:version-release), если передан флаг "--no_prev_ver"
	%h - Источник подзадания (gear|srpm) и хэш-сумма commit-a подзадания

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

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

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

===============================================================================
Ссылки

Проект на git.altlinux.org -
http://git.altlinux.org/people/alexey/packages/?p=alt-tasks.git

===============================================================================

https://www.altlinux.org/alt-tasks

Copyright (C) 2020-2025 Alexey Appolonov
