Theme error - build failing

[sr-murthy]

I have a (Gitlab) CI pipeline set up for a project where one of the stages builds Sphinx docs (currently, Sphinx version 7.2 in the Gitlab runner) on the branch for any given commit (the Sphinx Makefile build target is called). Usually this never fails, until recently when I started seeing this:

...
Theme error:
An error happened in rendering the page index.
Reason: AttributeError("'TocTree' object has no attribute 'get_toctree_ancestors'")
...

I'm using the Pydata theme (defined in conf.py), and the index.rst ToC directive, which hasn't changed, is below:

.. toctree::
   :maxdepth: 2
   :caption: Contents:

I note the recent version change in Sphinx. I've never seen this before with earlier versions of Sphinx, e.g. 7.0.2, 7.1.2 etc.

I'm not sure if it is Sphinx, or Pydata. Can someone please look at this?

[sr-murthy]

I changed the Sphinx version in the runner to 7.1.2 and the error went away. I'm wondering if there are changes in 7.2 that afffect the way that the ToC tree renders.

[sr-murthy]

So looks like a Sphinx issue after all

sphinx-doc/sphinx#11604

but there is a note there suggesting there could be a Pydata fix. Temporarily fix is to switch back to an earlier version of Sphinx.

[drammock]

The fix is already merged into main of the theme, but we haven't had a chance to cut a new release yet. Pinning to Sphinx<7.2 is the right fix for now. Unfortunately this Sphinx issue came up at the last minute before their release, and we have a couple of blocking issues that prevent us from an immediate release of the theme.

[AA-Turner]

This ought to be fixed in Sphinx 7.2.1.

A