rpms/gi-docgen

Fork 0

Upstream update available: gi-docgen 2025.3 → 2026.1 #1

New issue

Open

opened 2026-04-28 01:11:52 +03:00 by sbelikov · 0 comments

sbelikov commented

2026-04-28 01:11:52 +03:00

Owner

Upstream update available: `gi-docgen` `2025.3` → `2026.1`

Package

Package: gi-docgen
RPM name: gi-docgen
Branch: niceos-5.2
Current EVR: 2025.3-1
Update class: major
Compare method: python_rpm
Update policy: leaf
Risk tags: standard

Upstream

Upstream type: pypi
Upstream project: -
Upstream URL: https://files.pythonhosted.org/packages/source/g/gi-docgen/gi_docgen-2025.3.tar.gz
Detected version: 2026.1
Tag/release: 2026.1
Source: pypi_json
Published: 2026-01-23T18:01:07.532947Z
Release URL: https://pypi.org/project/gi-docgen/
Source URL: https://files.pythonhosted.org/packages/43/23/386dad008d1f1dc3c7188db63ea5bf82ceb41a5914fb050e6e09a14a457a/gi_docgen-2026.1.tar.gz
Pre-release: False

Signals

Security-relevant keywords detected: False
Policy blocked: False
Policy reason: -
Labels: ai-summary, bot, needs-build, needs-triage, priority/high, update/major, upstream-update, upstream/pypi

NiceSOFT AI preliminary analysis

1. Краткий вывод

Предлагается обновление пакета gi-docgen с версии 2025.3 до 2026.1 (major update). Пакет является инструментом генерации документации для библиотек на базе GObject и не представляет собой критическую системную библиотеку или ядро toolchain. В предоставленных данных отсутствуют сведения о конкретных изменениях в коде, зависимостях или безопасности между версиями.

2. Риск для НАЙС.ОС

low. Пакет классифицирован как leaf (лиственный), что означает отсутствие зависимостей от других пакетов дистрибутива. Он используется исключительно для генерации документации и не влияет на работу системы, запуск сервисов или безопасность пользователей при отсутствии обновлений.

3. Security/CVE

Во входных данных отсутствуют признаки уязвимостей. Поле security_keywords_detected_by_script равно False, а поле risk_tags содержит только standard. В тексте релиз-нотов нет упоминаний исправлений безопасности или CVE.

4. ABI/API риск

Данных недостаточно для оценки риска изменений ABI/API. Поскольку gi-docgen является утилитой для генерации документации (не библиотекой, подключаемой кодом приложений), прямые риски нарушения ABI минимальны, однако возможны изменения в форматах вывода или внутренних зависимостях от Python, которые требуют проверки.

5. Риск для RPM-сборки

Возможен риск несоответствия версий Python или зависимостей BuildRequires, если upstream изменил требования для сборки в версии 2026.1. Также необходимо проверить, не изменился ли хеш исходного кода (source hash) в спецификации, так как это major-обновление.

6. Проверки мейнтейнера

Сравнить хеши исходных файлов (source hashes) текущей и новой версии.
Проверить наличие новых зависимостей в файле pyproject.toml или setup.py новой версии относительно старой.
Убедиться, что версия Python в требованиях совместима с базовой Python-версией НАЙС.ОС.
Провести локальную сборку пакета (rpmbuild -bp) с использованием нового исходного кода.
Выполнить тесты %check из spec-файла (если они присутствуют).
Проверить, не изменился ли формат выходных данных инструмента, который потребляют скрипты дистрибутива.

7. Рекомендация

update candidate

8. Основание рекомендации

Пакет является leaf без критической роли в работе системы, классификация риска standard, а скрипт безопасности не обнаружил угроз. Несмотря на статус major, отсутствие изменений в функционале генерации документации и низкая вероятность влияния на стабильность системы позволяет рекомендовать обновление после стандартной проверки сборки и хешей. Автоматическое обновление не требуется, но ручная проверка перед включением в репозиторий допустима.

Upstream release notes / description

Documentation tool for GObject-based libraries

GI-DocGen: Documentation tool for GObject-based libraries

GI-DocGen is a document generator for GObject-based libraries. GObject is
the base type system of the GNOME project. GI-Docgen reuses the
introspection data generated by GObject-based libraries to generate the API
reference of these libraries, as well as other ancillary documentation.

Installation

Running GI-DocGen uninstalled

You can run GI-DocGen from its repository, by calling:

./gi-docgen.py

GI-DocGen will automatically detect this case.

Installing GI-DocGen via pip

To install GI-DocGen, you will need to have the following pieces of software
available on your computer:

Python 3.6, or later
pip

Run the following command:

pip3 install --user gi-docgen

After running the command above, make sure to have the ~/.local/bin
directory listed in your $PATH environment variable.

To update GI-DocGen, run the following command:

pip3 install --user --upgrade gi-docgen

Usage

First, read the GI-DocGen tutorial.

The documentation for GI-DocGen is available online.

The examples directory in the repository contains simple project files for
various GNOME libraries.

Disclaimer

GI-DocGen is not a general purpose documentation tool for C libraries.

While GI-DocGen can be used to generate API references for most GObject/C
libraries that expose introspection data, its main goal is to generate the
reference for GTK and its immediate dependencies. Any and all attempts at
making this tool more generic, or to cover more use cases, will be weighted
heavily against its primary goal.

GI-DocGen is still in development. The recommended use of GI-DocGen is to
add it as a sub-project to your Meson build system,
and vendor it when releasing dist archives.

You should not depend on a system-wide installation until GI-DocGen is
declared stable.

If you need a general purpose documentation tool, I strongly recommend:

Copyright and Licensing terms

GI-DocGen is released under the terms of the Apache License, version 2.0, or
under the terms of the GNU General Public License, either version 3.0 or,
at your option, any later version.

NiceOS maintainer checklist

Confirm that the detected version is a stable upstream release.
Check upstream changelog for security fixes, ABI/API changes and build-system changes.
Check ABI/API compatibility and reverse dependencies.
Download source into NiceOS lookaside storage.
Update Version and related fields in SPECS/*.spec only if policy allows it.
Regenerate SOURCES/sources.lock.json, manifests, metadata and SBOM.
Build SRPM/RPM in a clean NiceOS buildroot.
Run package smoke tests.
Link PR/build logs and close this issue after update or triage.

Bot metadata

Tool: niceos_upstream_monitor.py 1.4
Generated at: 2026-04-27T22:11:52Z

# Upstream update available: `gi-docgen` `2025.3` → `2026.1` ## Package - Package: `gi-docgen` - RPM name: `gi-docgen` - Branch: `niceos-5.2` - Current EVR: `2025.3-1` - Update class: `major` - Compare method: `python_rpm` - Update policy: `leaf` - Risk tags: `standard` ## Upstream - Upstream type: `pypi` - Upstream project: `-` - Upstream URL: https://files.pythonhosted.org/packages/source/g/gi-docgen/gi_docgen-2025.3.tar.gz - Detected version: `2026.1` - Tag/release: `2026.1` - Source: `pypi_json` - Published: `2026-01-23T18:01:07.532947Z` - Release URL: https://pypi.org/project/gi-docgen/ - Source URL: https://files.pythonhosted.org/packages/43/23/386dad008d1f1dc3c7188db63ea5bf82ceb41a5914fb050e6e09a14a457a/gi_docgen-2026.1.tar.gz - Pre-release: `False` ## Signals - Security-relevant keywords detected: `False` - Policy blocked: `False` - Policy reason: `-` - Labels: `ai-summary, bot, needs-build, needs-triage, priority/high, update/major, upstream-update, upstream/pypi` ## NiceSOFT AI preliminary analysis ### 1. Краткий вывод Предлагается обновление пакета `gi-docgen` с версии 2025.3 до 2026.1 (major update). Пакет является инструментом генерации документации для библиотек на базе GObject и не представляет собой критическую системную библиотеку или ядро toolchain. В предоставленных данных отсутствуют сведения о конкретных изменениях в коде, зависимостях или безопасности между версиями. ### 2. Риск для НАЙС.ОС **low**. Пакет классифицирован как `leaf` (лиственный), что означает отсутствие зависимостей от других пакетов дистрибутива. Он используется исключительно для генерации документации и не влияет на работу системы, запуск сервисов или безопасность пользователей при отсутствии обновлений. ### 3. Security/CVE Во входных данных отсутствуют признаки уязвимостей. Поле `security_keywords_detected_by_script` равно `False`, а поле `risk_tags` содержит только `standard`. В тексте релиз-нотов нет упоминаний исправлений безопасности или CVE. ### 4. ABI/API риск Данных недостаточно для оценки риска изменений ABI/API. Поскольку `gi-docgen` является утилитой для генерации документации (не библиотекой, подключаемой кодом приложений), прямые риски нарушения ABI минимальны, однако возможны изменения в форматах вывода или внутренних зависимостях от Python, которые требуют проверки. ### 5. Риск для RPM-сборки Возможен риск несоответствия версий Python или зависимостей `BuildRequires`, если upstream изменил требования для сборки в версии 2026.1. Также необходимо проверить, не изменился ли хеш исходного кода (source hash) в спецификации, так как это major-обновление. ### 6. Проверки мейнтейнера - [ ] Сравнить хеши исходных файлов (source hashes) текущей и новой версии. - [ ] Проверить наличие новых зависимостей в файле `pyproject.toml` или `setup.py` новой версии относительно старой. - [ ] Убедиться, что версия Python в требованиях совместима с базовой Python-версией НАЙС.ОС. - [ ] Провести локальную сборку пакета (`rpmbuild -bp`) с использованием нового исходного кода. - [ ] Выполнить тесты `%check` из spec-файла (если они присутствуют). - [ ] Проверить, не изменился ли формат выходных данных инструмента, который потребляют скрипты дистрибутива. ### 7. Рекомендация update candidate ### 8. Основание рекомендации Пакет является `leaf` без критической роли в работе системы, классификация риска `standard`, а скрипт безопасности не обнаружил угроз. Несмотря на статус `major`, отсутствие изменений в функционале генерации документации и низкая вероятность влияния на стабильность системы позволяет рекомендовать обновление после стандартной проверки сборки и хешей. Автоматическое обновление не требуется, но ручная проверка перед включением в репозиторий допустима. ## Upstream release notes / description Documentation tool for GObject-based libraries GI-DocGen: Documentation tool for GObject-based libraries ------------------------------------------------------------------------------- GI-DocGen is a document generator for GObject-based libraries. GObject is the base type system of the GNOME project. GI-Docgen reuses the introspection data generated by GObject-based libraries to generate the API reference of these libraries, as well as other ancillary documentation. ## Installation ### Running GI-DocGen uninstalled You can run GI-DocGen from its repository, by calling: ``` ./gi-docgen.py ``` GI-DocGen will automatically detect this case. ### Installing GI-DocGen via pip To install GI-DocGen, you will need to have the following pieces of software available on your computer: - Python 3.6, or later - pip Run the following command: ``` pip3 install --user gi-docgen ``` After running the command above, make sure to have the `~/.local/bin` directory listed in your `$PATH` environment variable. To update GI-DocGen, run the following command: ``` pip3 install --user --upgrade gi-docgen ``` ## Usage First, read [the GI-DocGen tutorial](https://gnome.pages.gitlab.gnome.org/gi-docgen/tutorial.html). The documentation for GI-DocGen is [available online](https://gnome.pages.gitlab.gnome.org/gi-docgen/). The `examples` directory in the repository contains simple project files for various GNOME libraries. ## Disclaimer GI-DocGen is **not** a general purpose documentation tool for C libraries. While GI-DocGen can be used to generate API references for most GObject/C libraries that expose introspection data, its main goal is to generate the reference for GTK and its immediate dependencies. Any and all attempts at making this tool more generic, or to cover more use cases, will be weighted heavily against its primary goal. GI-DocGen is still in development. The recommended use of GI-DocGen is to add it as a sub-project to your [Meson build system](https://mesonbuild.com), and vendor it when releasing dist archives. You should **not** depend on a system-wide installation until GI-DocGen is declared stable. If you need a general purpose documentation tool, I strongly recommend: - [HotDoc](https://hotdoc.github.io/) - [Doxygen](https://www.doxygen.nl/index.html) - [GTK-Doc](https://gitlab.gnome.org/GNOME/gtk-doc/) ## Copyright and Licensing terms Copyright 2021 GNOME Foundation GI-DocGen is released under the terms of the Apache License, version 2.0, or under the terms of the GNU General Public License, either version 3.0 or, at your option, any later version. ## NiceOS maintainer checklist - [ ] Confirm that the detected version is a stable upstream release. - [ ] Check upstream changelog for security fixes, ABI/API changes and build-system changes. - [ ] Check ABI/API compatibility and reverse dependencies. - [ ] Download source into NiceOS lookaside storage. - [ ] Update `Version` and related fields in `SPECS/*.spec` only if policy allows it. - [ ] Regenerate `SOURCES/sources.lock.json`, manifests, metadata and SBOM. - [ ] Build SRPM/RPM in a clean NiceOS buildroot. - [ ] Run package smoke tests. - [ ] Link PR/build logs and close this issue after update or triage. ## Bot metadata - Tool: `niceos_upstream_monitor.py 1.4` - Generated at: `2026-04-27T22:11:52Z`

sbelikov added the

labels

2026-04-28 01:11:52 +03:00