Bug 2180467

Summary:	python-behave fails to build with Sphinx 6.1.3
Product:	[Fedora] Fedora	Reporter:	Karolina Surma <ksurma>
Component:	python-behave	Assignee:	Ali Erdinc Koroglu <aekoroglu>
Status:	CLOSED RAWHIDE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	rawhide	CC:	aekoroglu, besser82, python-packagers-sig
Target Milestone:	---
Target Release:	---
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-04-05 12:40:12 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 14:34:50 UTC

python-behave fails to build with Sphinx 6.1.3 in Fedora 39 (currently Rawhide).

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

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

The issue detected:

Exception occurred:
File "/usr/lib/python3.11/site-packages/sphinx/ext/extlinks.py", line 103, in role
title = caption % part
        ~~~~~~~~^~~~~~
TypeError: not all arguments converted during string formatting

It's an error in configuration.
To resolve, edit the documentation `conf.py` and correct the `extlinks` definition to contain exactly one `%s` in the captions, eg.

Bad:
'github': ('https://github.com/%s', '')

Good:
'github': ('https://github.com/%s', '%s')

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

Comment 1 Ali Erdinc Koroglu 2023-03-23 10:16:19 UTC

Thank you for catching that :)

https://bodhi.fedoraproject.org/updates/FEDORA-2023-4871e1f1ed

Comment 2 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!