Alt-tasks: различия между версиями

Материал из ALT Linux Wiki
(Новая страница: «<b>alt-tasks</b> - консольная программа, предназначенная для поиска заданий по сборке пакетов и…»)
 
Нет описания правки
Строка 5: Строка 5:
== Использование ==
== Использование ==


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


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


<source><условное название данной цели>, <абсолютный путь в файловой системе></source>
<source><условное название данной цели>, <абсолютный путь в файловой системе></source>
Строка 24: Строка 24:


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


<source>alt-tasks --target p9 --after 2020-01-01 --update</source>
<source>alt-tasks --target p9 --after 2020-01-01 --update</source>

Версия от 21:27, 18 июня 2020

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

Ссылки

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