Fix TocTree manipulation on Sphinx 7.2+

[AA-Turner]

See #1404

This is the bare minimum required to restore the previous state. I intend to look into how pydata-sphinx-theme uses get_toctree_ancestors and if there are any longer-term improvements to be made.

A

[drammock]

you'll need to version-guard this import too:

Running Sphinx v5.3.0

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/pydata-sphinx-theme/envs/1406/lib/python3.9/site-packages/sphinx/config.py", line 350, in eval_config_file
    exec(code, namespace)
  File "/home/docs/checkouts/readthedocs.org/user_builds/pydata-sphinx-theme/checkouts/1406/docs/conf.py", line 14, in <module>
    import pydata_sphinx_theme
  File "/home/docs/checkouts/readthedocs.org/user_builds/pydata-sphinx-theme/envs/1406/lib/python3.9/site-packages/pydata_sphinx_theme/__init__.py", line 15, in <module>
    from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
  File "/home/docs/checkouts/readthedocs.org/user_builds/pydata-sphinx-theme/envs/1406/lib/python3.9/site-packages/pydata_sphinx_theme/toctree.py", line 14, in <module>
    from sphinx.environment.adapters.toctree import _get_toctree_ancestors, TocTree
ImportError: cannot import name '_get_toctree_ancestors' from 'sphinx.environment.adapters.toctree' (/home/docs/checkouts/readthedocs.org/user_builds/pydata-sphinx-theme/envs/1406/lib/python3.9/site-packages/sphinx/environment/adapters/toctree.py)

[AA-Turner]

oops, of course!

[drammock]

thanks @AA-Turner

[AA-Turner]

Thank you!

To make you aware, Sphinx 7.2 is planned for release this week, so users of pydata-sphinx-theme will need to use a version with this fix included.

A

[drammock]

thanks for the heads-up. We're overdue for a release anyway so I'll try to wrap up our remaining blockers ASAP