python312-sphinx missing extension failures

[Brian Inglis]

On 2026-09-14 08:03, Marco Atzeri via Cygwin-apps wrote:
> On 14/09/2026 08:26, Brian Inglis via Cygwin-apps wrote:
>> On 2026-01-22 13:13, Marco Atzeri via Cygwin wrote:
>>> On 22/01/2026 15:21, Jon Turney via Cygwin wrote:
>>>> On 30/12/2025 11:19, Marco Atzeri via Cygwin-announce wrote:
> 
>>
>> Hi folks,
>>
>> ITA jansson, build fails due to sphinx issue:
>>
>>
>> $ tail jansson-2.15.1-1.x86_64/log/jansson-2.15.1-1-compile.log
>> sphinx-build -b html -d _build/doctrees /usr/src/jansson/ 
>> jansson-2.15.1-1.x86_64/src/jansson-2.15.1/doc _build/html
>> Running Sphinx v7.4.7
>> loading translations [en]... done
>>
>> Extension error:
>> Could not import extension sphinx.builders.changes (exception: No module named 
>> 'tomli')
>> make[1]: *** [Makefile:461: html-local] Error 2
>> make[1]: Leaving directory '/usr/src/jansson/jansson-2.15.1-1.x86_64/ build/doc'
>> make: *** [Makefile:654: html-recursive] Error 1
>> *** ERROR: make failed
> 
> If you build only for python 312 does it work ?

As the process at bottom shows, I did eventually find and install all 
dependencies, step by step, rerunning the sphinx-build manually to find the 
missing modules.

> $ cygcheck -cd |grep sphinx
> python312-sphinx                           9.1.0-1
> python312-sphinx-notfound-page             1.1.0-1
> python312-sphinx_rtd_theme                 3.1.0-1
> python312-sphinxcontrib-applehelp          2.0.0-1
> python312-sphinxcontrib-devhelp            2.0.0-1
> python312-sphinxcontrib-htmlhelp           2.1.0-1
> python312-sphinxcontrib-jsmath             1.0.1-3
> python312-sphinxcontrib-qthelp             2.0.0-1
> python312-sphinxcontrib-serializinghtml    2.0.0-1
> python312-sphinxcontrib-websupport         2.0.0-1
> 
> python39-sphinx                            7.4.7-1
> python39-sphinx-copybutton                 0.5.2-1
> python39-sphinx-notfound-page              1.1.0-1
> python39-sphinx_rtd_theme                  3.1.0-1
> python39-sphinxcontrib-applehelp           2.0.0-1
> python39-sphinxcontrib-devhelp             2.0.0-1
> python39-sphinxcontrib-htmlhelp            2.1.0-1
> python39-sphinxcontrib-jsmath              1.0.1-3
> python39-sphinxcontrib-qthelp              2.0.0-1
> python39-sphinxcontrib-serializinghtml     2.0.0-1
> python39-sphinxcontrib-websupport          2.0.0-1

>> Needs ChangesBuilders and HTMLBuilders - similar split dependency cause?
>>
>> Looks like latest update just upgraded python39-sphinx... to 7.4.7 rather than 
>> replacing with python312-sphinx 9.1.0.
> 
> 9.1.0 for 3.12
> 7.4.7 for 3.9 (it was the last before the limit of >=3.10 that most package now 
> have)
>> Can I encourage this with some setup or cygport b-r tweak(s)?
>>
>> Meanwhile I will add explicit python312-sphinx b-r and see if that works?
>>
>> Locally I will have to update-alternatives as:
>> $ file /etc/alternatives/sphinx-build
>> /etc/alternatives/sphinx-build: symbolic link to /usr/bin/sphinx-build-3.9
>>
>> $ alternatives --config sphinx-build
>>
>> There is 2 program that provides 'sphinx-build'.
>>
>>    Selection    Command
>> -----------------------------------------------
>>   + 1           /usr/bin/sphinx-build-3.9
>> *  2           /usr/bin/sphinx-build-3.12
>>
>> Enter to keep the current selection[+], or type selection number: 2
>> $ alternatives --display sphinx-build
>> sphinx-build - status is manual.
>>   link currently points to /usr/bin/sphinx-build-3.12
>> /usr/bin/sphinx-build-3.9 - priority 39
>> /usr/bin/sphinx-build-3.12 - priority 312
>> Current `best' version is /usr/bin/sphinx-build-3.12.
>>
>> Rerunning thru the failures due to missing extensions:
>>
>> ...alabaster
>>
>> Installed python3-alabaster python312-alabaster and also below and added to b-r:
>>
>> ...sphinxcontrib.applehelp!
>> ...sphinxcontrib.htmlhelp
>> ...sphinxcontrib.serializinghtml
>> ...sphinxcontrib.qthelp
>>
>> Should they be added to sphinx-build or other sphinx-... package requires?
>>
>> Maybe we need a virtual sphinx package to install all required?
>>
> 
> There should be a circular dependency and all the
> python312-sphinxcontrib-xxx packages should be
> installed together at python312-sphinx
> 
> I will look of the dependency

Could you please also look at updating and providing python3{12,}-fonttools, 
when you get time for more pythoning, as they are required to pass graphite2 
upgrade tests, so I can confidently adopt and deploy.

I will see if trying "python3-fonttools python312-fonttools python39-fonttools" 
b-r in Scallywag allows them to complete, as the first two are do not exist.
I have python312 and 39 installed and python312 preferred locally, so 
39-fonttools will not work.

-- 
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher  but when there is no more to cut
                                 -- Antoine de Saint-Exupéry