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

Версия от 23:16, 3 июля 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

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

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

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

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

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

Ссылки

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

@@ Строка 9: / Строка 9: @@
 Выборка запрашиваемой информации осуществляется по данным, получаемым из <code>d-t-s-evr.list</code> файлов, поиск которых осуществляется в каталогах, которые должны быть указаны пользователем в файле <code>~/.alt-task/src_list</code> в следующем формате:
-<source><условное название данной цели>, <абсолютный путь в файловой системе></source>
+::<source><условное название данной цели>, <абсолютный путь в файловой системе></source>
 Так, например, при работе на сервере <i>ALT Linux Team</i>, данный файл мог бы иметь следующий вид:
-<source>
+::<source>
 sisyphus, /ALT/repo/sisyphus/index/src
 p9, /ALT/repo/p9/index/src
@@ Строка 21: / Строка 21: @@
 Пример команды поиска заданий в репозиторий <i>sisyphus</i>, прошедших commit после 26 сентября 2017 года, но до 1 января 2020 года (при этом считается, что содержимое файла <code>src_list</code> соответствует указанному выше):
-<source>alt-tasks --target sisyphus --after 2017-09-26 --before 2020-01-01</source>
+::<source>alt-tasks --target sisyphus --after 2017-09-26 --before 2020-01-01</source>
 По завершению работы программы в домашнем каталоге может быть создан двоичный файл <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>
 Пользователь может запретить создавать бинарные копии, запустив приложение с флагом <code>--notrace</code>:
-<source>alt-tasks --target p9 --after 2020-01-01 --notrace</source>
+::<source>alt-tasks --target p9 --after 2020-01-01 --notrace</source>
+Программа поддерживает возможность задания произвольного формата вывода; Доступны следующие преобразования:
+::{| class="wikitable"
+|<i>%d</i>
+|Дата и время commit-а задания
+|-
+|<i>%t</i>
+|Номер задания
+|-
+|<i>%s</i>
+|Номер подзадания
+|-
+|<i>%n</i>
+|Название пакета
+|-
+|<i>%v</i>
+|Версия пакета (<i>epoch:version-release</i>)
+|-
+|<i>%h</i>
+|Хэш-сумма commit-a задания
+|}
+Так, например, для вывода номеров заданий и соответствующих им названий и версий пакетов с запятыми в качестве разделителей, следует задать:
+::<source>alt-tasks <прочие параметры> --format "%t,%n,%v"</source>
+Для активации подробного вывода (сообщений о выполняемых операциях и статусе завершения этих операций) следует использовать флаг <code>--verbose</code>.
 == Ссылки ==