From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <rider@basealt.ru>
X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on
 sa.local.altlinux.org
X-Spam-Level: 
X-Spam-Status: No, score=-3.4 required=5.0 tests=BAYES_00,DKIM_SIGNED,
 DKIM_VALID,DKIM_VALID_AU,RP_MATCHES_RCVD autolearn=ham autolearn_force=no
 version=3.4.1
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=basealt.ru; s=dkim;
 t=1775040710;
 h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
 to:to:cc:mime-version:mime-version:content-type:content-type:
 content-transfer-encoding:content-transfer-encoding;
 bh=bpJy38l/d7ENCZ7cndTOYCxEayABfs91sppYU2RHD2w=;
 b=gFZ3i4JzEb0SC37Ja0FBO4pPbPz9mkIbjSMRpLmr/SdRqmY6o3+JRGzsefR/efMWVDjjb+
 +5z8Hk6tgsSVCMtxvdf4JM9xAYI9aRW0wd50QlSNqRyg7f1EEYkyIEHKE9eDNriVFl3Cb/
 dDQoz6yP0T4lGabcGiinBwECWvV4hXI/ScnP7XMUpXfxrqX9+UJ11+gCdy+cml4TQw/tP+
 bONgJuLyo8D0lgo7wX4aHnO6mZeom/bWtNYiX+BW6kayblrhAKWkazwDMSgEWS3MU2z5Oy
 XhBQwFc5gUyw12gqlbteay8iMLLtBw7OQE1Idyw9OMjLX8+/vpJ5A2uuk0EKVQ==
Message-ID: <ddf6c03f-aa4f-4e8e-8850-ac9d8910963c@basealt.ru>
Date: Wed, 1 Apr 2026 13:51:50 +0300
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Content-Language: ru
To: ALT Linux Team development discussions <devel@lists.altlinux.org>
From: Anton Farygin <rider@basealt.ru>
Organization: BaseALT
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Subject: [devel] I: API for girar tasks
X-BeenThere: devel@lists.altlinux.org
X-Mailman-Version: 2.1.12
Precedence: list
Reply-To: ALT Linux Team development discussions <devel@lists.altlinux.org>
List-Id: ALT Linux Team development discussions <devel.lists.altlinux.org>
List-Unsubscribe: <https://lists.altlinux.org/mailman/options/devel>,
 <mailto:devel-request@lists.altlinux.org?subject=unsubscribe>
List-Archive: <http://lists.altlinux.org/pipermail/devel>
List-Post: <mailto:devel@lists.altlinux.org>
List-Help: <mailto:devel-request@lists.altlinux.org?subject=help>
List-Subscribe: <https://lists.altlinux.org/mailman/listinfo/devel>,
 <mailto:devel-request@lists.altlinux.org?subject=subscribe>
X-List-Received-Date: Wed, 01 Apr 2026 10:51:53 -0000
Archived-At: <http://lore.altlinux.org/devel/ddf6c03f-aa4f-4e8e-8850-ac9d8910963c@basealt.ru/>
List-Archive: <http://lore.altlinux.org/devel/>
List-Post: <mailto:devel@altlinux.org>

Привет.

На git.altlinux.org начал работать сервис, отдающий данные о задачах 
girar по HTTP в JSON.

  https://git.altlinux.org/tasks/api/openapi.json

Зачем это было делать.

girar task ls и girar task show --json работают по SSH и каждый раз 
читают файловую систему. Это медленно и неудобно, если хочется делать
автоматизацию, писать ботов, мониторинг или просто быстро посмотреть 
состояние задач из скрипта. taskoteka держит все задачи в памяти 
иобновляет кеш раз в 5 секунд, ответы приходят мгновенно и для доступа к 
информации не нужно участие в ALT Linux Team с доступом к ssh.

Примеры использования:

Список задач с фильтрами:

  # Активные задачи (AWAITING, BUILDING, COMMITTING, FAILING, PENDING, 
POSTPONED)
  curl -s https://git.altlinux.org/tasks/api/tasks | jq .

  # Задачи конкретного пользователя
  curl -s 'https://git.altlinux.org/tasks/api/tasks?user=rider'

  # EPERM в p11
  curl -s 'https://git.altlinux.org/tasks/api/tasks?state=EPERM&repo=p11'

  # Несколько стейтов
  curl -s 'https://git.altlinux.org/tasks/api/tasks?state=BUILDING,FAILING'

Полнотекстовый поиск — ищет по id, owner, repo, стейту, message
и полям сабтасков (pkgname, dir, tag_name):

  # Найти EPERM задачи в p11 с "lib" в имени пакета
  curl -s 'https://git.altlinux.org/tasks/api/tasks?q=p11+EPERM+lib'

В ответе приходит поле matches, где видно, в каких полях совпало.

Задачи, ожидающие approve:

  # EPERM задачи, которым не хватает approve мейнтейнера
  curl -s 'https://git.altlinux.org/tasks/api/tasks?needs_approval=maint'

  # То же для тестировщиков, только p11
  curl -s 
'https://git.altlinux.org/tasks/api/tasks?needs_approval=tester&repo=11'

Полная информация о задаче (формат совместим с girar task show --json):

  curl -s https://git.altlinux.org/tasks/api/tasks/389466 | jq .

Включает статус сборки по архитектурам, комментарии 
approved_by/disapproved_by
с датами, EVR пакетов.

Server-Sent Events — подписка на изменения в реальном времени:

  curl -N https://git.altlinux.org/tasks/api/events

Приходят события task_new, task_updated, task_removed — удобно для 
ботов и дашбордов, не надо поллить.

Список владельцев задач:

  curl -s https://git.altlinux.org/tasks/api/owners

Формат ответа стандартный JSON. В заголовках приходит x-api-version и 
x-cache-age

(сколько секунд назад обновился кеш). OpenAPI-спецификация доступна
по GET /openapi.json — можно загрузить в Swagger UI.


Все данные в памяти, кеш обновляется раз в 5 секунд. Ответы на запросы —
меньше миллисекунды. Архивные задачи читаются с диска по запросу.

Исходники, баги и пожелания:
https://altlinux.space/rider/taskoteka

OCaml, лицензия GPL-2.0-or-later.