[HEADS UP] Planned Sphinx update to 4.x - many packages fail to build

[Karolina Surma]

Hello,

As you may already know [0], we plan to upgrade the Python documentation 
framework Sphinx to a new major version - currently it's 4.0.2.
The update will take place on Monday, *June 28th*.

Packages that stopped building or running with the newest Sphinx stack 
were identified during the test build in the Copr repository [1].
There are still a lot of packages which fail to build.
Please, if you haven't already, check the build logs and work with the 
upstream towards fixing the failures.
Feel free to use the Copr repository to test your package there.

For details regarding the Sphinx update, see the associated Fedora 
Change [0].

Having questions or in need of help? Don't hesitate to contact me.
You can reply to this thread or find ksurma on #fedora-python IRC 
channel (libera.chat).

Best regards,
Karolina Surma

[0] https://fedoraproject.org/wiki/Changes/Sphinx4 
<https://fedoraproject.org/wiki/Changes/Sphinx4>
[1] https://copr.fedorainfracloud.org/coprs/ksurma/pygments-2.9.0/ 
<https://copr.fedorainfracloud.org/coprs/ksurma/pygments-2.9.0/>(don't 
be confused by the 
name)<https://copr.fedorainfracloud.org/coprs/ksurma/pygments-2.9.0/>


Maintainers by package:
Mayavi               chedi orion
ansible              kevin toshio wzzrd
ara                  dmsimard
arbor                ankursinha
borgbackup           fschwarz
botan                thm
condor               bbockelm bcotton eerlands matt matyas stevetraylen 
tstclair ttheisen valtri
copr-keygen          clime dturecek frostyx msuchy praiskup
gcc                  aoliva jakub law mpolacek
ghc                  petersen
kea                  landgraf thozza zdohnal
libgpuarray          jjames
php-opencloud-openstack lcts
python-BTrees        jjames
python-anyio         carlwgeorge fab
python-djvulibre     terrycloth
python-f5-sdk        xavierb
python-glue          lgs
python-h2            eclipseo
python-libpysal      qulogic
python-listparser    atim limb
python-novaclient    apevec jruzicka
python-openstackclient apevec
python-patsy         sergiopr
python-persistent    jjames
python-pkginfo       thrnciar
python-pycryptodomex melmorabity
python-pynetdicom    alciregi
python-pyswarms      iztokf
python-rjsmin        kwizart mrunge
python-ruffus        qulogic
python-sphinx-tabs   hobbes1069
python-sphinxcontrib-asyncio fab
python-sphinxcontrib-phpdomain fab
python-sphinxcontrib-trio jcaratzas thm
python-texext        jjames
python-txtorcon      decathorpe
python-whoosh        rkuska sgallagh
python-zarr          qulogic
rebase-helper        nforro phracek
tortoisehg           kiilerix nbecker
waiverdb             gnaponie lholecek lucarval mprahl ralph vmaljulin
xeus                 qulogic
xtl                  qulogic

Packages by maintainer:
alciregi   python-pynetdicom
ankursinha arbor
aoliva     gcc
apevec     python-novaclient python-openstackclient
atim       python-listparser
bbockelm   condor
bcotton    condor
carlwgeorge python-anyio
chedi      Mayavi
clime      copr-keygen
decathorpe python-txtorcon
dmsimard   ara
dturecek   copr-keygen
eclipseo   python-h2
eerlands   condor
fab        python-anyio python-sphinxcontrib-asyncio 
python-sphinxcontrib-phpdomain
frostyx    copr-keygen
fschwarz   borgbackup
gnaponie   waiverdb
hobbes1069 python-sphinx-tabs
iztokf     python-pyswarms
jakub      gcc
jcaratzas  python-sphinxcontrib-trio
jjames     libgpuarray python-BTrees python-persistent python-texext
jruzicka   python-novaclient
kevin      ansible
kiilerix   tortoisehg
kwizart    python-rjsmin
landgraf   kea
law        gcc
lcts       php-opencloud-openstack
lgs        python-glue
lholecek   waiverdb
limb       python-listparser
lucarval   waiverdb
matt       condor
matyas     condor
melmorabity python-pycryptodomex
mpolacek   gcc
mprahl     waiverdb
mrunge     python-rjsmin
msuchy     copr-keygen
nbecker    tortoisehg
nforro     rebase-helper
orion      Mayavi
petersen   ghc
phracek    rebase-helper
praiskup   copr-keygen
qulogic    python-libpysal python-ruffus python-zarr xeus xtl
ralph      waiverdb
rkuska     python-whoosh
sergiopr   python-patsy
sgallagh   python-whoosh
stevetraylen condor
terrycloth python-djvulibre
thm        botan python-sphinxcontrib-trio
thozza     kea
thrnciar   python-pkginfo
toshio     ansible
tstclair   condor
ttheisen   condor
valtri     condor
vmaljulin  waiverdb
wzzrd      ansible
xavierb    python-f5-sdk
zdohnal    kea

[Miroslav Suchý]

Dne 22. 06. 21 v 18:34 Karolina Surma napsal(a):
>  Feel free to use the Copr repository to test your package there.
Tip - if you want to test locally then:

mock -r fedora-rawhide-x86_64 
--addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/pygments-2.9.0/fedora-rawhide-x86_64/
--no-clean 
your.src.rpm

mock -r fedora-rawhide-x86_64 
--addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/pygments-2.9.0/fedora-rawhide-x86_64/
shell

Miroslav

[Felix Schwarz]

Am 22.06.21 um 18:34 schrieb Karolina Surma:
>  borgbackup           fschwarz 
Thank you for your work on Sphinx. borgbackup should be fixed in rawhide.

Felix

[Pavel Zhukov]

On 2021-06-22 at 18:34 CEST, Karolina Surma wrote...
>  Hello,
>  
Hello,

>  kea                  landgraf thozza zdohnal 
Should be fixed
with 1.9.8 release I've pushed to rawhide today. 

-- 
Pavel

[Miroslav Suchý]

Dne 22. 06. 21 v 18:34 Karolina Surma napsal(a):
>  copr-keygen clime dturecek frostyx msuchy praiskup 

This is caused by python3-sphinxcontrib-httpdomain

I filed https://bugzilla.redhat.com/show_bug.cgi?id=1975260

Miroslav

[Jerry James]

On Tue, Jun 22, 2021 at 10:35 AM Karolina Surma <ksurma(a)redhat.com&gt; wrote:
>  jjames     libgpuarray python-BTrees python-persistent python-texext
I have fixed libgpuarray and python-texext in Rawhide.  The other two
are actually due to a Sphinx 4 incompatibility in
python-repoze-sphinx-autointerface, which is now fixed in Rawhide as
well.
-- 
Jerry James
http://www.jamezone.org/

[Karolina Surma]

Hello,

I'd like to inform you that python-sphinx 4.0.2 has landed in Rawhide as 
planned [0].

This means you no longer need to use the test Copr. You can now test 
your packages using Koji scratch build as you're used to.

koji build --scratch rawhide <srpm>


Thank you to all who have helped with mitigating the impact of the upgrade.

There are still some packages with issues whose maintainers I've BCC'd. 
Please take a look at them. If you already have, please ignore the 
notification.

I'll be opening Bugzillas for the remaining packages, so that the 
information is not lost in the thread.

Feel free to reach me through this thread or ping on #fedora-python on 
libera.chat (ksurma).


Cheers,

Karolina Surma


[0] https://fedoraproject.org/wiki/Changes/Sphinx4



Maintainers by package:
Mayavi               chedi orion
ansible              kevin toshio wzzrd
ara                  dmsimard
arbor                ankursinha
botan                thm
condor               bbockelm bcotton eerlands matt matyas stevetraylen 
tstclair ttheisen valtri
copr-keygen          clime dturecek frostyx msuchy praiskup     - 
blocked by python-sphinxcontrib-httpdomain FTI
gcc                  aoliva jakub law mpolacek
ghc                  petersen
php-opencloud-openstack lcts
python-djvulibre     terrycloth
python-f5-sdk        xavierb
python-glue          lgs
python-h2            eclipseo
python-libpysal      qulogic
python-patsy         sergiopr
python-pkginfo       thrnciar
python-pycryptodomex melmorabity
python-pynetdicom    alciregi
python-pyswarms      iztokf
python-rjsmin        kwizart mrunge
python-ruffus        qulogic
python-sphinx-tabs   hobbes1069
python-sphinxcontrib-asyncio fab
python-sphinxcontrib-httpdomain dcallagh
python-sphinxcontrib-phpdomain fab
python-sphinxcontrib-trio jcaratzas thm
python-whoosh        rkuska sgallagh
python-zarr          qulogic
rebase-helper        nforro phracek
tortoisehg           kiilerix nbecker
waiverdb             gnaponie lholecek lucarval mprahl ralph vmaljulin
xeus                 qulogic
xtl                  qulogic

Packages by maintainer:
alciregi   python-pynetdicom
ankursinha arbor
aoliva     gcc
bbockelm   condor
bcotton    condor
chedi      Mayavi
clime      copr-keygen
dcallagh   python-sphinxcontrib-httpdomain
dmsimard   ara
dturecek   copr-keygen
eclipseo   python-h2
eerlands   condor
fab        python-sphinxcontrib-asyncio python-sphinxcontrib-phpdomain
frostyx    copr-keygen
gnaponie   waiverdb
hobbes1069 python-sphinx-tabs
iztokf     python-pyswarms
jakub      gcc
jcaratzas  python-sphinxcontrib-trio
kevin      ansible
kiilerix   tortoisehg
kwizart    python-rjsmin
law        gcc
lcts       php-opencloud-openstack
lgs        python-glue
lholecek   waiverdb
lucarval   waiverdb
matt       condor
matyas     condor
melmorabity python-pycryptodomex
mpolacek   gcc
mprahl     waiverdb
mrunge     python-rjsmin
msuchy     copr-keygen
nbecker    tortoisehg
nforro     rebase-helper
orion      Mayavi
petersen   ghc
phracek    rebase-helper
praiskup   copr-keygen
qulogic    python-libpysal python-ruffus python-zarr xeus xtl
ralph      waiverdb
rkuska     python-whoosh
sergiopr   python-patsy
sgallagh   python-whoosh
stevetraylen condor
terrycloth python-djvulibre
thm        botan python-sphinxcontrib-trio
thrnciar   python-pkginfo
toshio     ansible
tstclair   condor
ttheisen   condor
valtri     condor
vmaljulin  waiverdb
wzzrd      ansible
xavierb    python-f5-sdk