python312-sphinx missing extension failures

[Brian Inglis]

On 2026-09-14 19:08, Brian Inglis via Cygwin-apps wrote:
> 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

[Not sphinx - fonttools]

> 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.

Even with Scallywag CI GH python39 base and python39-fonttools installed, ctest 
reports the only failures for a few graphite2 font tests in job id=12591:

Traceback (most recent call last):
   File 
"/cygdrive/d/a/scallywag/graphite2/graphite2-1.3.15-1.x86_64/src/graphite2-1.3.15/tests/fnttxtrender", 
line 14, in <module>
     from fontTools.ttLib import TTFont
ModuleNotFoundError: No module named 'fontTools'

so I am wondering what is the issue there?

$ grep '^class\sTTFont' \
	/usr/lib/python3.9/site-packages/fontTools/ttLib/ttFont.py
class TTFont(object):

-- 
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