Apr 20, 2025 · Apr 10, 2025
diff --git a/doc/devel/testing.rst b/doc/devel/testing.rst

 It is preferred that new tests use ``style='mpl20'`` as this leads to smaller
 figures and reflects the newer look of default Matplotlib plots. Also, if the
 texts (labels, tick labels, etc) are not really part of what is tested, use
 ``remove_text=True`` as this will lead to smaller figures and reduce possible
 issues with font mismatch on different platforms.
 texts (labels, tick labels, etc) are not really part of what is tested, use the
 ``remove_text=True`` argument or add the ``text_placeholders`` fixture as this
 will lead to smaller figures and reduce possible issues with font mismatch on
 different platforms.


 Compare two methods of creating an image
diff --git a/lib/matplotlib/testing/conftest.py b/lib/matplotlib/testing/conftest.py

 xr=pytest.importorskip('xarray')
 returnxr


 @pytest.fixture
 deftext_placeholders(monkeypatch):
 """
    Replace texts with placeholder rectangles.

    The rectangle size only depends on the font size and the number of characters. It is
    thus insensitive to font properties and rendering details. This should be used for
    tests that depend on text geometries but not the actual text rendering, e.g. layout
    tests.
    """
 frommatplotlib.patchesimportRectangle

 defpatched_get_text_metrics_with_cache(renderer,text,fontprop,ismath,dpi):
 """
        Replace ``_get_text_metrics_with_cache`` with fixed results.

        The usual ``renderer.get_text_width_height_descent`` would depend on font
        metrics; instead the fixed results are based on font size and the length of the
        string only.
        """
 # While get_window_extent returns pixels and font size is in points, font size
 # includes ascenders and descenders. Leaving out this factor and setting
 # descent=0 ends up with a box that is relatively close to DejaVu Sans.
 height=fontprop.get_size()
 width=len(text)*height/1.618# Golden ratio for character size.
 descent=0
 returnwidth,height,descent

 defpatched_text_draw(self,renderer):
 """
        Replace ``Text.draw`` with a fixed bounding box Rectangle.

        The bounding box corresponds to ``Text.get_window_extent``, which ultimately
        depends on the above patched ``_get_text_metrics_with_cache``.
        """
 ifrendererisnotNone:
 self._renderer=renderer
 ifnotself.get_visible():
 return
 ifself.get_text()=='':
 return
 bbox=self.get_window_extent()
 rect=Rectangle(bbox.p0,bbox.width,bbox.height,
 facecolor=self.get_color(),edgecolor='none')
 rect.draw(renderer)

 monkeypatch.setattr('matplotlib.text._get_text_metrics_with_cache',
 patched_get_text_metrics_with_cache)
 monkeypatch.setattr('matplotlib.text.Text.draw',patched_text_draw)
diff --git a/lib/matplotlib/testing/conftest.pyi b/lib/matplotlib/testing/conftest.pyi
 def pd() -> ModuleType: ...
 @pytest.fixture
 def xr() -> ModuleType: ...
 @pytest.fixture
 def text_placeholders(monkeypatch: pytest.MonkeyPatch) -> None: ...
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout1.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout1.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout10.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout10.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout11.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout11.png
diff --git a/...lotlib/tests/baseline_images/test_constrainedlayout/constrained_layout11rat.png b/...lotlib/tests/baseline_images/test_constrainedlayout/constrained_layout11rat.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout12.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout12.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout13.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout13.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout14.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout14.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout15.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout15.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout16.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout16.png
diff --git a/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout17.png b/...atplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout17.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout2.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout2.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout3.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout3.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout4.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout4.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout5.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout5.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout6.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout6.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout8.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout8.png
diff --git a/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout9.png b/...matplotlib/tests/baseline_images/test_constrainedlayout/constrained_layout9.png
diff --git a/...lib/tests/baseline_images/test_constrainedlayout/test_colorbars_no_overlapH.png b/...lib/tests/baseline_images/test_constrainedlayout/test_colorbars_no_overlapH.png
diff --git a/...lib/tests/baseline_images/test_constrainedlayout/test_colorbars_no_overlapV.png b/...lib/tests/baseline_images/test_constrainedlayout/test_colorbars_no_overlapV.png
diff --git a/lib/matplotlib/tests/baseline_images/test_table/table_cell_manipulation.png b/lib/matplotlib/tests/baseline_images/test_table/table_cell_manipulation.png
diff --git a/lib/matplotlib/tests/baseline_images/test_tightlayout/tight_layout1.pdf b/lib/matplotlib/tests/baseline_images/test_tightlayout/tight_layout1.pdf
diff --git a/lib/matplotlib/tests/baseline_images/test_tightlayout/tight_layout1.png b/lib/matplotlib/tests/baseline_images/test_tightlayout/tight_layout1.png
Original file line number	Diff line number	Diff line change
Expand Up		@@ -161,9 +161,10 @@ the tests, they should now pass.

		It is preferred that new tests use ``style='mpl20'`` as this leads to smaller
		figures and reflects the newer look of default Matplotlib plots. Also, if the
		texts (labels, tick labels, etc) are not really part of what is tested, use
		``remove_text=True`` as this will lead to smaller figures and reduce possible
		issues with font mismatch on different platforms.
		texts (labels, tick labels, etc) are not really part of what is tested, use the
		``remove_text=True`` argument or add the ``text_placeholders`` fixture as this
		will lead to smaller figures and reduce possible issues with font mismatch on
		different platforms.


		Compare two methods of creating an image
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -125,3 +125,54 @@ def test_imshow_xarray(xr):

		xr=pytest.importorskip('xarray')
		returnxr


		@pytest.fixture
		deftext_placeholders(monkeypatch):
		"""
		Replace texts with placeholder rectangles.

		The rectangle size only depends on the font size and the number of characters. It is
		thus insensitive to font properties and rendering details. This should be used for
		tests that depend on text geometries but not the actual text rendering, e.g. layout
		tests.
		"""
		frommatplotlib.patchesimportRectangle

		defpatched_get_text_metrics_with_cache(renderer,text,fontprop,ismath,dpi):
		"""
		Replace ``_get_text_metrics_with_cache`` with fixed results.

		The usual ``renderer.get_text_width_height_descent`` would depend on font
		metrics; instead the fixed results are based on font size and the length of the
		string only.
		"""
		# While get_window_extent returns pixels and font size is in points, font size
		# includes ascenders and descenders. Leaving out this factor and setting
		# descent=0 ends up with a box that is relatively close to DejaVu Sans.
		height=fontprop.get_size()
		width=len(text)*height/1.618# Golden ratio for character size.
		descent=0
		returnwidth,height,descent

		defpatched_text_draw(self,renderer):
		"""
		Replace ``Text.draw`` with a fixed bounding box Rectangle.

		The bounding box corresponds to ``Text.get_window_extent``, which ultimately
		depends on the above patched ``_get_text_metrics_with_cache``.
		"""
		ifrendererisnotNone:
		self._renderer=renderer
		ifnotself.get_visible():
		return
		ifself.get_text()=='':
		return
		bbox=self.get_window_extent()
		rect=Rectangle(bbox.p0,bbox.width,bbox.height,
		facecolor=self.get_color(),edgecolor='none')
		rect.draw(renderer)

		monkeypatch.setattr('matplotlib.text._get_text_metrics_with_cache',
		patched_get_text_metrics_with_cache)
		monkeypatch.setattr('matplotlib.text.Text.draw',patched_text_draw)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,3 +10,5 @@ def mpl_test_settings(request: pytest.FixtureRequest) -> None: ...
		def pd() -> ModuleType: ...
		@pytest.fixture
		def xr() -> ModuleType: ...
		@pytest.fixture
		def text_placeholders(monkeypatch: pytest.MonkeyPatch) -> None: ...