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

Версия от 20:49, 17 ноября 2023

alt-tasks-explorer — набор приложений и запускающая их консольная программа, использующая приложение alt-tasks для поиска заданий по сборке пакетов ALT Linux, после чего осуществляющая запуск приложений из набора для получения информации об этих заданиях.

Все составляющие написаны на Python. Распространяется по лицензии GPLv3.0.

Принцип работы

alt-tasks-explorer читает список исходных файлов, после чего запускает приложение alt-tasks:

<alt-tasks> --src_name <путь_к_списку_исходных_файлов> --format "%t %s %b %n %v" --no_prev_ver

Где <alt-tasks> обозначает команду alt-tasks или иной способ запуска приложения alt-tasks (путь к исполняемому файлу, подробнее см. раздел Использование). Результатом выполнения такой команды является список подзаданий, каждая строка которого включает номер задания, номер подзадания, название ветви Sisyphus, название пакета, версию и релиз пакета. Далее полученный список используется в качестве входных данных запускаемого модуля-обработчика, который назначается командой запуска alt-tasks-explorer.

Использование

Для правильной работы программы alt-tasks-explorer, ей должен быть передан способ запуска приложения alt-tasks, т.к. в системе, в частности на сервере ALT Linux Team, оно может быть не установлено, что не должно мешать осуществлять поиск информации по заданиям, информация о которых размещена на данном сервере. По-умолчанию, значение этого параметра равно alt-tasks, но если в системе приложение alt-tasks не установлено, то следует передать в качестве значения данного параметра полный путь к соответствующему исполняемому файлу (например, скопированному в домашний каталог). Все параметры запуска alt-tasks-explorer приведены в следующей таблице:

Параметр	Описание
`-h, --help`	Вывод справки
`--alt_tasks_util SHELL_CMD_OR_FILE_PATH`	Способ запуска приложения alt-tasks (значение по-умолчанию - `alt-tasks`)
`--src_list SRC_LIST_FILE_PATH`	Пусть к файлу, содержащему список названий исходных пакетов, задания по сборке которых подлежат обработке
`-p MODULE_TO_RUN_OVER_FOUND_TASKS, --process MODULE_TO_RUN_OVER_FOUND_TASKS`	Краткое наименование модуля-обрабочика, который должен быть вызван для всех найденных подзаданий по сборке пакетов из списка
`-o DIR_PATH, --out_dir DIR_PATH`	Полный путь к каталогу, в который будут записаны результы

Формат списка исходных пакетов

Cписок исходных пакетов может состоять из записей двух типов:

Полное наименование пакета, включающее название, версию, релиз и суффикс .src.rpm;
Только название пакета (без названия, версии, релиза и суффикса .src.rpm).

Наличие суффикса .src.rpm служит обозначением, что данная запись представляет собой полное наименование пакета. При наличии записи с полным наименованем пакета в результирующую выборку будут добавлены только те задания, в которых был собран пакет с соответствующей версией и релизом. Пример (вторая и третья записи представляют собой полное обозначение пакетов, а первая - только название):

alt-tasks
control++-0.21.2-alt1.src.rpm
cve-manager-0.82.2-alt1.src.rpm

Ссылки

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

@@ Строка 35: / Строка 35: @@
 |Полный путь к каталогу, в который будут записаны результы
 |}
+== Формат списка исходных пакетов ==
+Cписок исходных пакетов может состоять из записей двух типов:
+* Полное наименование пакета, включающее название, версию, релиз и суффикс <code>.src.rpm</code>;
+* Только название пакета (без названия, версии, релиза и суффикса <code>.src.rpm</code>).
+Наличие суффикса <code>.src.rpm</code> служит обозначением, что данная запись представляет собой полное наименование пакета. При наличии записи с полным наименованем пакета в результирующую выборку будут добавлены только те задания, в которых был собран пакет с соответствующей версией и релизом. Пример (вторая и третья записи представляют собой полное обозначение пакетов, а первая - только название):
+::<source lang="text">
+alt-tasks
+control++-0.21.2-alt1.src.rpm
+cve-manager-0.82.2-alt1.src.rpm
+</source>
 == Ссылки ==