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

Текущая версия от 15:41, 20 апреля 2022

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

@@ Строка 1: / Строка 1: @@
-<b>alt-tasks</b> - консольная программа, предназначенная для поиска заданий по сборке пакетов и дальнейшему выводу информации по найденным заданиям; Поиск осуществляется по критериям, задаваемым аргументами команды запуска программы.
+<b>alt-tasks</b> — консольная программа, предназначенная для поиска заданий по сборке пакетов и дальнейшему выводу информации по найденным заданиям. Поиск осуществляется по критериям, задаваемым аргументами команды запуска программы.
 Написана на Go. Распространяется по лицензии GPLv3.0.
@@ Строка 9: / Строка 9: @@
 Выборка запрашиваемой информации осуществляется по данным, получаемым из <code>d-t-s-evr.list</code> файлов, поиск которых осуществляется в каталогах, которые должны быть указаны пользователем в файле <code>~/.alt-task/src_list</code> в следующем формате:
-<source><условное название данной цели>, <абсолютный путь в файловой системе></source>
+::<source lang="text"><условное название данной цели>, <абсолютный путь в файловой системе></source>
 Так, например, при работе на сервере <i>ALT Linux Team</i>, данный файл мог бы иметь следующий вид:
-<source>
+::<source lang="text">
 sisyphus, /ALT/repo/sisyphus/index/src
 p9, /ALT/repo/p9/index/src
-p9, /ALT/repo/p8/index/src
+p8, /ALT/repo/p8/index/src
 </source>
 Пример команды поиска заданий в репозиторий <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 lang="text">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>
+По завершению работы программы в домашнем каталоге может быть создан двоичный файл <code>~/.alt-task/<target>.dmp</code>, содержащий собранную информацию по всем заданиям репозитория, исследованного при данном запуске (далее "бинарные копии"). Бинарные копии будут использоваться при последующих запусках с тем же значением параметра <code>--target</code>, если после создания данного файла прошло менее одного часа (бинарные копии, с момента создания которых прошло больше времени, будут удалены), время выполнения программы при этом уменьшается крайне существенно. Пользователь может запретить использовать существующие бинарные копии, запустив приложение с флагом <code>--update</code>
 (например, если возможно изменение репозитория в интервале времени, меньшем чем срок годности бинарных копий):
-<source>alt-tasks --target p9 --after 2020-01-01 --update</source>
+::<source lang="text">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 lang="text">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 lang="text">alt-tasks <прочие параметры> --format "%t,%n,%v"</source>
+Для активации подробного вывода (сообщений о выполняемых операциях и статусе завершения этих операций) следует использовать флаг <code>--verbose</code>.
 == Ссылки ==