rpms/python3-docutils

Fork 0

Upstream update available: python3-docutils 0.21.2 → 0.22.4 #1

New issue

Open

opened 2026-04-28 01:48:34 +03:00 by sbelikov · 0 comments

sbelikov commented

2026-04-28 01:48:34 +03:00

Owner

Upstream update available: `python3-docutils` `0.21.2` → `0.22.4`

Package

Package: python3-docutils
RPM name: python3-docutils
Branch: niceos-5.2
Current EVR: 0.21.2-1
Update class: minor
Compare method: python_rpm
Update policy: leaf
Risk tags: standard

Upstream

Upstream type: pypi
Upstream project: -
Upstream URL: https://files.pythonhosted.org/packages/source/d/docutils/docutils-0.21.2.tar.gz
Detected version: 0.22.4
Tag/release: 0.22.4
Source: pypi_json
Published: 2025-12-18T19:00:26.443107Z
Release URL: https://pypi.org/project/docutils/
Source URL: https://files.pythonhosted.org/packages/ae/b6/03bb70946330e88ffec97aefd3ea75ba575cb2e762061e0e62a213befee8/docutils-0.22.4.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/medium, update/minor, upstream-update, upstream/pypi

NiceSOFT AI preliminary analysis

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

Предлагается обновление библиотеки python3-docutils с версии 0.21.2 до 0.22.4. Обновление классифицируется как минорное (minor), однако релиз-ноты указывают на введение синтаксиса подсказок типов (type hints) для Python 3.10, что потенциально затрагивает совместимость с более старыми версиями интерпретатора. Автоматическое обновление не рекомендуется без предварительной проверки требований к версии Python в системе.

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

medium.
Хотя обновление помечено как минорное, введение поддержки синтаксиса Python 3.10 в type hints может вызвать проблемы при компиляции или загрузке модуля, если в дистрибутиве используются Python версии ниже 3.10 и не настроена переменная окружения TYPE_CHECKING. Также требуется убедиться, что зависимые пакеты поддерживают изменения API/ABI, если они были внесены в рамках этого релиза.

3. Security/CVE

Во входных данных отсутствуют явные указания на уязвимости безопасности. Поле security_keywords_detected_by_script равно False, а в тексте релиз-нот не упоминаются исправления уязвимостей (CVE) или изменения в механизмах обработки ввода/вывода, характерные для security-патчей.

4. ABI/API риск

Нужен ручной ABI/API анализ.
Релиз-ноты явно упоминают добавление type hints с использованием синтаксиса Python 3.10. Это может привести к ошибкам импорта (SyntaxError) в средах с Python < 3.10, если код не обернут в проверку if sys.version_info >= (3, 10) или если переменная TYPE_CHECKING не установлена корректно. Необходимо проверить, как пакет обрабатывает старые версии Python и нет ли изменений в публичном API, влияющих на внешних потребителей.

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

Возможен сбой сборки или проверки (%check), если:

В BuildRequires или Requires не указана жесткая зависимость от python3 >= 3.10 (если пакет перестал поддерживать старые версии).
Скрипты сборки или тесты используют функции или синтаксис, недоступный в старых версиях Python, присутствующих в НАЙС.ОС.
Изменились требования к зависимостям (например, новые версии setuptools или wheel), которые могут отсутствовать в текущей сборочной среде.

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

Проверить минимальную требуемую версию Python в релиз-нотах (упомянуто требование 3.9+, но синтаксис 3.10).
Убедиться, что в spec файле корректно заданы зависимости от Python, соответствующие новой версии пакета.
Провести локальную сборку пакета на целевых версиях Python, используемых в НАЙС.ОС.
Запустить %check секцию на тестовой машине с минимальной поддерживаемой версией Python.
Проверить отсутствие конфликтов с другими пакетами, использующими docutils (например, python3-sphinx, python3-pygments).

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

update candidate

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

Обновление является минорным и не содержит критических security-уязвимостей согласно предоставленным данным. Несмотря на потенциальные нюансы с type hints для Python 3.10, пакет остается функциональным инструментом, и риск блокирующего сбоя низок при условии корректной настройки зависимостей от Python. Рекомендуется включить в очередь кандидатов на обновление после прохождения стандартных проверок совместимости.

Upstream release notes / description

Docutils -- Python Documentation Utilities

=========================
README: Docutils 0.22.4

:Author: David Goodger
:Contact: goodger@python.org
:Date: Date: 2025-12-18 19:44:54 +0100 (Do, 18. Dez 2025)
:Web site: https://docutils.sourceforge.io/
:Copyright: This document has been placed in the public domain.

:Abstract: Docutils is a modular system for processing documentation into
useful formats, such as HTML, XML, and LaTeX.
For input Docutils supports reStructuredText, an easy-to-read,
what-you-see-is-what-you-get plaintext markup syntax.

.. contents::

Quick-Start

This is for those who want to get up & running quickly.

Docutils requires Python, available from
https://www.python.org/.
See Dependencies_ below for details.
Install the latest stable release from PyPi with pip_::
```
pip install docutils
```
For alternatives and details, see section Installation_ below.
Use the front-end scripts_ to convert reStructuredText documents.
Try for example::
```
docutils FAQ.rst FAQ.html
```
See Usage_ below for details.

Purpose

The purpose of the Docutils project is to provide a set of tools for
processing plaintext documentation into useful formats, such as HTML,
LaTeX, troff (man pages), OpenOffice, and native XML. Support for the
following sources has been implemented:

Standalone files.
PEPs (Python Enhancement Proposals)_.

Support for the following sources is planned or provided by
third party tools_:

Inline documentation from Python modules and packages, extracted
with namespace context.
Email (RFC-822 headers, quoted excerpts, signatures, MIME parts).
Wikis, with global reference lookups of "wiki links".
Compound documents, such as multiple chapter files merged into a
book.
And others as discovered.

.. _PEPs (Python Enhancement Proposals):
https://peps.python.org/pep-0012
.. _third party tools: docs/user/links.html#related-applications

Dependencies

To run the code, Python_ must be installed.
(Python is pre-installed with most Linux distributions.)

Since version 0.21, Docutils requires Python 3.9 or later.
Docutils versions 0.19 to 0.20.1 require Python 3.7 or later.
Docutils versions 0.16 to 0.18 require Python 2.7 or 3.5+.

The type hints added in version 0.22 use Python 3.10 syntax.
However, the Python interpreter treats them as annotations
unless typing.TYPE_CHECKING is set to True.

.. _Python: https://www.python.org/.

Recommendations

Docutils uses the following packages for enhanced functionality, if they
are installed:

The recommended installer is pip_, setuptools_ works, too.
The Python Imaging Library_ (PIL) is used for some image
manipulation operations.
The Pygments_ package provides syntax highlight of "code" directives
and roles.
The myst, pycmark, or recommonmark_ parsers can be used to
parse input in "Markdown" (CommonMark_) format.

The Docutils Link List <docs/user/links.html>__ records projects that
users of Docutils and reStructuredText may find useful.

.. _pip: https://pypi.org/project/pip/
.. _setuptools: https://pypi.org/project/setuptools/
.. _Python Imaging Library: http://www.pythonware.com/products/pil/
.. _Pygments: https://pypi.org/project/Pygments/
.. _myst: https://pypi.org/project/myst-docutils/
.. _pycmark: https://pypi.org/project/pycmark/
.. _recommonmark: https://github.com/rtfd/recommonmark
.. _CommonMark: https://spec.commonmark.org/0.30/

Installation

The Python Packaging User Guide_ gives details how to
use pip for installing_.

The simplest way is to install the latest stable release from PyPi::
```
pip install docutils
```
To install a pre-relase, append the option --pre.
To install a development version_ from source:
1. Open a shell
2. Go to the directory containing the pyproject.toml file.
3. Install the package with one of the

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:48:34Z

# Upstream update available: `python3-docutils` `0.21.2` → `0.22.4` ## Package - Package: `python3-docutils` - RPM name: `python3-docutils` - Branch: `niceos-5.2` - Current EVR: `0.21.2-1` - Update class: `minor` - Compare method: `python_rpm` - Update policy: `leaf` - Risk tags: `standard` ## Upstream - Upstream type: `pypi` - Upstream project: `-` - Upstream URL: https://files.pythonhosted.org/packages/source/d/docutils/docutils-0.21.2.tar.gz - Detected version: `0.22.4` - Tag/release: `0.22.4` - Source: `pypi_json` - Published: `2025-12-18T19:00:26.443107Z` - Release URL: https://pypi.org/project/docutils/ - Source URL: https://files.pythonhosted.org/packages/ae/b6/03bb70946330e88ffec97aefd3ea75ba575cb2e762061e0e62a213befee8/docutils-0.22.4.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/medium, update/minor, upstream-update, upstream/pypi` ## NiceSOFT AI preliminary analysis ### 1. Краткий вывод Предлагается обновление библиотеки `python3-docutils` с версии 0.21.2 до 0.22.4. Обновление классифицируется как минорное (minor), однако релиз-ноты указывают на введение синтаксиса подсказок типов (type hints) для Python 3.10, что потенциально затрагивает совместимость с более старыми версиями интерпретатора. Автоматическое обновление не рекомендуется без предварительной проверки требований к версии Python в системе. ### 2. Риск для НАЙС.ОС **medium**. Хотя обновление помечено как минорное, введение поддержки синтаксиса Python 3.10 в type hints может вызвать проблемы при компиляции или загрузке модуля, если в дистрибутиве используются Python версии ниже 3.10 и не настроена переменная окружения `TYPE_CHECKING`. Также требуется убедиться, что зависимые пакеты поддерживают изменения API/ABI, если они были внесены в рамках этого релиза. ### 3. Security/CVE Во входных данных отсутствуют явные указания на уязвимости безопасности. Поле `security_keywords_detected_by_script` равно `False`, а в тексте релиз-нот не упоминаются исправления уязвимостей (CVE) или изменения в механизмах обработки ввода/вывода, характерные для security-патчей. ### 4. ABI/API риск Нужен ручной ABI/API анализ. Релиз-ноты явно упоминают добавление type hints с использованием синтаксиса Python 3.10. Это может привести к ошибкам импорта (`SyntaxError`) в средах с Python < 3.10, если код не обернут в проверку `if sys.version_info >= (3, 10)` или если переменная `TYPE_CHECKING` не установлена корректно. Необходимо проверить, как пакет обрабатывает старые версии Python и нет ли изменений в публичном API, влияющих на внешних потребителей. ### 5. Риск для RPM-сборки Возможен сбой сборки или проверки (`%check`), если: - В `BuildRequires` или `Requires` не указана жесткая зависимость от `python3 >= 3.10` (если пакет перестал поддерживать старые версии). - Скрипты сборки или тесты используют функции или синтаксис, недоступный в старых версиях Python, присутствующих в НАЙС.ОС. - Изменились требования к зависимостям (например, новые версии `setuptools` или `wheel`), которые могут отсутствовать в текущей сборочной среде. ### 6. Проверки мейнтейнера - [ ] Проверить минимальную требуемую версию Python в релиз-нотах (упомянуто требование 3.9+, но синтаксис 3.10). - [ ] Убедиться, что в `spec` файле корректно заданы зависимости от Python, соответствующие новой версии пакета. - [ ] Провести локальную сборку пакета на целевых версиях Python, используемых в НАЙС.ОС. - [ ] Запустить `%check` секцию на тестовой машине с минимальной поддерживаемой версией Python. - [ ] Проверить отсутствие конфликтов с другими пакетами, использующими `docutils` (например, `python3-sphinx`, `python3-pygments`). ### 7. Рекомендация update candidate ### 8. Основание рекомендации Обновление является минорным и не содержит критических security-уязвимостей согласно предоставленным данным. Несмотря на потенциальные нюансы с type hints для Python 3.10, пакет остается функциональным инструментом, и риск блокирующего сбоя низок при условии корректной настройки зависимостей от Python. Рекомендуется включить в очередь кандидатов на обновление после прохождения стандартных проверок совместимости. ## Upstream release notes / description Docutils -- Python Documentation Utilities ========================= README: Docutils 0.22.4 ========================= :Author: David Goodger :Contact: goodger@python.org :Date: $Date: 2025-12-18 19:44:54 +0100 (Do, 18. Dez 2025) $ :Web site: https://docutils.sourceforge.io/ :Copyright: This document has been placed in the public domain. :Abstract: Docutils is a modular system for processing documentation into useful formats, such as HTML, XML, and LaTeX. For input Docutils supports reStructuredText, an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax. .. contents:: Quick-Start =========== This is for those who want to get up & running quickly. 1. Docutils requires **Python**, available from https://www.python.org/. See Dependencies_ below for details. 2. Install the latest stable release from PyPi with pip_:: pip install docutils For alternatives and details, see section `Installation`_ below. 3. Use the `front-end scripts`_ to convert reStructuredText documents. Try for example:: docutils FAQ.rst FAQ.html See Usage_ below for details. Purpose ======= The purpose of the Docutils project is to provide a set of tools for processing plaintext documentation into useful formats, such as HTML, LaTeX, troff (man pages), OpenOffice, and native XML. Support for the following sources has been implemented: * Standalone files. * `PEPs (Python Enhancement Proposals)`_. Support for the following sources is planned or provided by `third party tools`_: * Inline documentation from Python modules and packages, extracted with namespace context. * Email (RFC-822 headers, quoted excerpts, signatures, MIME parts). * Wikis, with global reference lookups of "wiki links". * Compound documents, such as multiple chapter files merged into a book. * And others as discovered. .. _PEPs (Python Enhancement Proposals): https://peps.python.org/pep-0012 .. _third party tools: docs/user/links.html#related-applications Dependencies ============ To run the code, Python_ must be installed. (Python is pre-installed with most Linux distributions.) * Since version 0.21, Docutils requires Python 3.9 or later. * Docutils versions 0.19 to 0.20.1 require Python 3.7 or later. * Docutils versions 0.16 to 0.18 require Python 2.7 or 3.5+. The **type hints** added in version 0.22 use Python 3.10 syntax. However, the Python interpreter treats them as annotations unless ``typing.TYPE_CHECKING`` is set to ``True``. .. _Python: https://www.python.org/. Recommendations --------------- Docutils uses the following packages for enhanced functionality, if they are installed: * The recommended installer is pip_, setuptools_ works, too. * The `Python Imaging Library`_ (PIL) is used for some image manipulation operations. * The `Pygments`_ package provides syntax highlight of "code" directives and roles. * The `myst`_, `pycmark`_, or `recommonmark`_ parsers can be used to parse input in "Markdown" (CommonMark_) format. The `Docutils Link List <docs/user/links.html>`__ records projects that users of Docutils and reStructuredText may find useful. .. _pip: https://pypi.org/project/pip/ .. _setuptools: https://pypi.org/project/setuptools/ .. _Python Imaging Library: http://www.pythonware.com/products/pil/ .. _Pygments: https://pypi.org/project/Pygments/ .. _myst: https://pypi.org/project/myst-docutils/ .. _pycmark: https://pypi.org/project/pycmark/ .. _recommonmark: https://github.com/rtfd/recommonmark .. _CommonMark: https://spec.commonmark.org/0.30/ Installation ============ The `Python Packaging User Guide`_ gives details how to `use pip for installing`_. * The simplest way is to install the latest *stable release* from PyPi:: pip install docutils * To install a *pre-relase*, append the option ``--pre``. * To install a `development version`_ *from source*: 1. Open a shell 2. Go to the directory containing the ``pyproject.toml`` file. 3. Install the package with **one** of the ## 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:48:34Z`

sbelikov added the

labels

2026-04-28 01:48:34 +03:00