DOC: Hide pybind11 base object from inheritance

QuLogic · QuLogic · commit a0649e792797 · 2024-09-11T20:45:17.000-04:00
And also ignore the `numpy.float64` reference. The latter seems to be
broken since Sphinx tries to auto-link type hints as `py:class`, but
it's an alias in NumPy making it a `py:attr` in their inventory.
diff --git a/doc/conf.py b/doc/conf.py
@@ -230,6 +230,20 @@ def tutorials_download_error(record):
 autodoc_docstring_signature = True
 autodoc_default_options = {'members': None, 'undoc-members': None}
 
+
+def autodoc_process_bases(app, name, obj, options, bases):
+    """
+    Hide pybind11 base object from inheritance tree.
+
+    Note, *bases* must be modified in place.
+    """
+    for cls in bases[:]:
+        if not isinstance(cls, type):
+            continue
+        if cls.__module__ == 'pybind11_builtins' and cls.__name__ == 'pybind11_object':
+            bases.remove(cls)
+
+
 # make sure to ignore warnings that stem from simply inspecting deprecated
 # class-level attributes
 warnings.filterwarnings('ignore', category=DeprecationWarning,
@@ -847,5 +861,6 @@ def setup(app):
         bld_type = 'rel'
     app.add_config_value('skip_sub_dirs', 0, '')
     app.add_config_value('releaselevel', bld_type, 'env')
+    app.connect('autodoc-process-bases', autodoc_process_bases)
     if sphinx.version_info[:2] < (7, 1):
         app.connect('html-page-context', add_html_cache_busting, priority=1000)
diff --git a/doc/missing-references.json b/doc/missing-references.json
@@ -268,6 +268,9 @@
       "<unknown>:1",
       "doc/api/_as_gen/mpl_toolkits.axisartist.floating_axes.rst:32:<autosummary>:1"
     ],
+    "numpy.float64": [
+      "doc/docstring of matplotlib.ft2font.PyCapsule.set_text:1"
+    ],
     "numpy.uint8": [
       "<unknown>:1"
     ]
