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

Материал из ALT Linux Wiki
Нет описания правки
Нет описания правки
Строка 9: Строка 9:
Выборка запрашиваемой информации осуществляется по данным, получаемым из <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>


Так, например, при работе на сервере <i>ALT Linux Team</i>, данный файл мог бы иметь следующий вид:
Так, например, при работе на сервере <i>ALT Linux Team</i>, данный файл мог бы иметь следующий вид:


<source>
::<source>
sisyphus, /ALT/repo/sisyphus/index/src
sisyphus, /ALT/repo/sisyphus/index/src
p9, /ALT/repo/p9/index/src
p9, /ALT/repo/p9/index/src
Строка 21: Строка 21:
Пример команды поиска заданий в репозиторий <i>sisyphus</i>, прошедших commit после 26 сентября 2017 года, но до 1 января 2020 года (при этом считается, что содержимое файла <code>src_list</code> соответствует указанному выше):
Пример команды поиска заданий в репозиторий <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>
По завершению работы программы в домашнем каталоге может быть создан двоичный файл <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>:
Пользователь может запретить создавать бинарные копии, запустив приложение с флагом <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>.


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

Версия от 20: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