Restore TocTree.get_toctree_ancestors()

AA-Turner · AA-Turner · commit ec3185373044 · 2023-08-17T15:53:30.000+01:00
diff --git a/CHANGES b/CHANGES
@@ -21,6 +21,8 @@ Bugs fixed
   This will be removed in Sphinx 9.
 * Restored calls to ``Builder.add_{css,js}_file()``,
   which several extensions relied upon.
+* Restored the private API ``TocTree.get_toctree_ancestors()``,
+  which several extensions relied upon.
 
 Testing
 -------
diff --git a/sphinx/environment/adapters/toctree.py b/sphinx/environment/adapters/toctree.py
@@ -508,6 +508,9 @@ def resolve(self, docname: str, builder: Builder, toctree: addnodes.toctree,
             includehidden=includehidden,
         )
 
+    def get_toctree_ancestors(self, docname: str) -> list[str]:
+        return [*_get_toctree_ancestors(self.env.toctree_includes, docname)]
+
     def get_toc_for(self, docname: str, builder: Builder) -> Node:
         return document_toc(self.env, docname, self.env.app.builder.tags)
 

Original file line number	Diff line number	Diff line change
`@@ -508,6 +508,9 @@ def resolve(self, docname: str, builder: Builder, toctree: addnodes.toctree,`
`508`	`508`	`includehidden=includehidden,`
`509`	`509`	`)`
`510`	`510`
	`511`	`+ def get_toctree_ancestors(self, docname: str) -> list[str]:`
	`512`	`+ return [*_get_toctree_ancestors(self.env.toctree_includes, docname)]`
	`513`	`+`
`511`	`514`	`def get_toc_for(self, docname: str, builder: Builder) -> Node:`
`512`	`515`	`return document_toc(self.env, docname, self.env.app.builder.tags)`
`513`	`516`