Bug 2180497

Summary: python-sphinxcontrib-asyncio is not compatible with Sphinx 6.1.3
Product: [Fedora] Fedora Reporter: Karolina Surma <ksurma>
Component: python-sphinxcontrib-asyncioAssignee: Fabian Affolter <mail>
Status: NEW --- QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 39CC: code, mail
Target Milestone: ---Keywords: Reopened
Target Release: ---Flags: ksurma: needinfo? (mail)
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-03-21 17:53:59 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 2135122    

Description Karolina Surma 2023-03-21 15:05:03 UTC
python-asyncpg fails to build with Sphinx 6.1.3 in Fedora 39 (currently Rawhide).

The issue detected:

Exception occurred:
  File "/usr/lib/python3.11/site-packages/sphinx/domains/python.py", line 540, in handle_signature
    raise TypeError(
TypeError: Python directive method get_signature_prefix() must return a list of nodes. Return value was 'coroutine '.

For the logs from testing build attempts, see:
https://copr.fedorainfracloud.org/coprs/ksurma/sphinx-6.1.3/package/python-asyncpg/

You can test you package in mock running:

$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-6.1.3/fedora-rawhide-x86_64/ --no-clean your.src.rpm
$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-6.1.3/fedora-rawhide-x86_64/ shell

Sphinx 6.1.3 will be included in Fedora 39.
Let us know here if you have any questions. Thank you!

Comment 1 Ben Beasley 2023-03-21 17:01:33 UTC
This is related to: https://github.com/sphinx-doc/sphinx/issues/9832

The incompatibility is in sphinxcontrib-asyncio.

Upstream issue: https://github.com/aio-libs/sphinxcontrib-asyncio/issues/15

I am reassigning this to python-sphinxcontrib-asyncio and will disable the documentation in python-asyncpg as a workaround.

Comment 2 Fedora Update System 2023-03-21 17:52:56 UTC
FEDORA-2023-80c68b58e3 has been submitted as an update to Fedora 39. https://bodhi.fedoraproject.org/updates/FEDORA-2023-80c68b58e3

Comment 3 Fedora Update System 2023-03-21 17:53:59 UTC
FEDORA-2023-80c68b58e3 has been pushed to the Fedora 39 stable repository.
If problem still persists, please make note of it in this bug report.

Comment 4 Karolina Surma 2023-04-05 09:30:55 UTC
Hi,

This is a friendly notice that Sphinx 6.1.3 will be shipped to Fedora Rawhide on April 13th. This package - unless fixed - will start to FTBFS.
I'll be happy to help with fixing the issues, should you need it.
If this package has already been handled, please ignore this message and ideally close the ticket. Thank you!

Comment 5 Fedora Release Engineering 2023-08-16 07:12:15 UTC
This bug appears to have been reported against 'rawhide' during the Fedora Linux 39 development cycle.
Changing version to 39.