Bug 280323

Summary: textproc/py-sphinx: dependency textproc/py-docutils outside the limit
Product: Ports & Packages Reporter: Rainer Hurling <rhurlin>
Component: Individual Port(s)Assignee: freebsd-python (Nobody) <python>
Status: New ---    
Severity: Affects Some People CC: agh, rhurlin, tatsuki_makino
Priority: --- Flags: bugzilla: maintainer-feedback? (python)
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
Patch to raise the limit for docutils to <= 0.21.2 none

Description Rainer Hurling freebsd_committer freebsd_triage 2024-07-17 08:03:48 UTC 
Created attachment 252120 [details]
Patch to raise the limit for docutils to <= 0.21.2

Since the update of textproc/py-docutils to v0.21.2, the limits for this dependency in textproc/py-sphinx are too tight (< 0.20).

The limitations can be found in pyproject.toml and in PKG-INFO.

The real problem is that the port textproc/py-sphinx is still on version 5.3.0, while upstream is already 7.4.5. Since version 7.3.0 [1] docutils 0.21 are supported, the limitation in the ports so far is actually only supported since Sphinx 7.0.1 [2] ...

Are there plans to upgrade Sphinx to a current version in the near future? If not, would a patch of the current version in the ports be conceivable? In the latter case, I have attached a patch with which Sphinx seems to work sufficiently.


[1] https://www.sphinx-doc.org/en/master/changes.html#release-7-3-0-released-apr-16-2024
[2] https://www.sphinx-doc.org/en/master/changes.html#release-7-0-1-released-may-12-2023
Comment 1 commit-hook freebsd_committer freebsd_triage 2024-07-18 16:51:18 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/ports/commit/?id=0591f458605ba393099fb5ed8a2b67ba30b84577

commit 0591f458605ba393099fb5ed8a2b67ba30b84577
Author:     Po-Chuan Hsieh <sunpoet@FreeBSD.org>
AuthorDate: 2024-07-18 16:47:57 +0000
Commit:     Po-Chuan Hsieh <sunpoet@FreeBSD.org>
CommitDate: 2024-07-18 16:47:57 +0000

    textproc/py-sphinx: Fix c0615e6aa3e51781df0cf60379b4b8fc69d1a6c0

    - Bump PORTREVISION for package change

    pyproject.toml patch is needed when RUN_DEPENDS is modified.

    PR:             280323
    Reported by:    rhurlin

 textproc/py-sphinx/Makefile                         |  2 +-
 textproc/py-sphinx/files/patch-pyproject.toml (new) | 11 +++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)
Comment 2 Po-Chuan Hsieh freebsd_committer freebsd_triage 2024-07-18 17:06:57 UTC 
(In reply to Rainer Hurling from comment #0)

I totally agree that textproc/py-sphinx should be updated at least 7.3.0.
Comment 3 Alastair Hogge 2024-07-18 23:35:37 UTC 
Some past work on updating textproc/py-sphinx, bug #268018 (https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=268018)
Comment 4 Tatsuki Makino 2024-09-20 09:05:24 UTC 
Is it okay here as to the version of python itself?

It seems that the following commit contains syntax from version 3.9 or later.
https: //sourceforge.net /p/docutils/code/9533/

As a result, textproc/py-sphinx@py38 cannot be built.

The py39 environment is still maintained because I want to experiment with the operation of py39->py311 migration.
However, as the number of such py3[89] modules has increased, it seems that it is becoming difficult to continue to support them.