[Doc]: Build failures on CircleCI #31019
Description
Documentation Link
No response
Problem
Since a few days ago, docs have been failing to build on CircleCI with:
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FFMpegFileWriter.frame_format [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FFMpegFileWriter.frame_size [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FFMpegFileWriter.output_args [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FileMovieWriter.frame_size [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FileMovieWriter.supported_formats [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FuncAnimation.pause [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FuncAnimation.resume [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FuncAnimation.save [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FuncAnimation.to_html5_video [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FuncAnimation.to_jshtml [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.HTMLWriter.frame_format [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.HTMLWriter.frame_size [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.ImageMagickFileWriter.frame_format [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.ImageMagickFileWriter.frame_size [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.ImageMagickWriter.frame_size [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.ImageMagickWriter.supported_formats [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.MovieWriter.frame_size [ref.obj]
/home/circleci/project/doc/:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.PillowWriter.frame_size [ref.obj]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches._Style [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Curve [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ArrowStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches._Style [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches._Style [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ConnectionStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ConnectionStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ConnectionStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ConnectionStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches.ConnectionStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axes_grid1.axes_size._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.patches._Style [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axisartist.axisline_style.AxislineStyle._Base [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axisartist.axislines._FixedAxisArtistHelperBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axisartist.axislines._FloatingAxisArtistHelperBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axisartist.axislines._FixedAxisArtistHelperBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: mpl_toolkits.axisartist.axislines._FloatingAxisArtistHelperBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.backend_bases._Backend [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.backends._backend_pdf_ps.RendererPDFPSBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.backends._backend_pdf_ps.RendererPDFPSBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.backends._backend_tk.FigureCanvasTk [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.backends._backend_tk.FigureCanvasTk [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolCopyToClipboardBase'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolSetCursor'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolForward'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolFullScreen'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolGrid'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolMinorGrid'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolHelpBase'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolHome'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolPan'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolCursorPosition'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolQuit'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolQuitAll'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.RubberbandBase'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.SaveFigureBase'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ConfigureSubplotsBase'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolViewsPositions'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolXScale'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolYScale'> [ref.class]
<unknown>:1: WARNING: py:class reference target not found: <class 'matplotlib.backend_tools.ToolZoom'>} [ref.class]
<unknown>:1: WARNING: py:class reference target not found: numpy.typing.NDArray [ref.class]
<unknown>:1: WARNING: py:class reference target not found: numpy.float64 [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.image._ImageBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.image._ImageBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.image._ImageBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.text._AnnotationBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.projections.geo._GeoTransform [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.text._AnnotationBase [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.transforms._BlendedMixin [ref.class]
<unknown>:4: WARNING: py:class reference target not found: matplotlib.transforms._BlendedMixin [ref.class]
Seemingly, the difference between the last working and first failing build has been docutils 0.21.4->0.22.4, sphinx 8.2.3->9.1.0, and sphinx-design 0.6.1->0.7.0. Unfortunately, updating my venv to use these versions, I cannot reproduce the failures locally.
Looking at the warnings, there seems to be something wrong with parsing source locations, as there are many <unknown> or /home/circleci/project/doc/ (which seems to have been split or made relative incorrectly somehow?) but for items that should already be in the ignore file.
Suggested improvement
As I can't reproduce, it's difficult to come up with a fix. I've written up these notes in case someone else has some ideas.