Creating @skipif_font_missing

lib/matplotlib/testing/decorators.py

@@ -8,6 +8,7 @@
 import string
 import sys
 import warnings
+import matplotlib.font_manager as fm
 
 from packaging.version import parse as parse_version
 
@@ -18,6 +19,8 @@
 from .compare import comparable_formats, compare_images, make_test_filename
 from .exceptions import ImageComparisonFailure
 
+import pytest
+
 
 @contextlib.contextmanager
 def _cleanup_cm():
@@ -462,3 +465,24 @@
     result_dir = Path().resolve() / "result_images" / module_path.stem
     result_dir.mkdir(parents=True, exist_ok=True)
     return baseline_dir, result_dir
+
+
+def skipif_font_missing(fonts):
+    """
+    Decorator to skip a test if any of the specified fonts are missing.
+
+    Usage example:
+        @skipif_font_missing(['Dejavu Sans', 'Noto SansTC'])
+        def test_font(family_name):
+            # testing code
+    """
+    def decorator(func):
+        def wrapper(family_name):
+            for font in fonts:
+                fp = fm.FontProperties(family=[font])
+                found_file_name = Path(fm.findfont(fp)).name
+                if found_file_name not in fonts:
+                    pytest.skip(f"Font {font} is missing")
+                return func(family_name)
+        return wrapper
+    return decorator

lib/matplotlib/testing/decorators.pyi

@@ -23,3 +23,4 @@ def check_figures_equal(
     *, extensions: Sequence[str] = ..., tol: float = ...
 ) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
 def _image_directories(func: Callable) -> tuple[Path, Path]: ...
+def skipif_font_missing(fonts: list[str]) -> Callable[[Callable], Callable]: ...

lib/matplotlib/tests/test_ft2font.py

@@ -4,7 +4,7 @@
 import pytest
 
 from matplotlib import ft2font
-from matplotlib.testing.decorators import check_figures_equal
+from matplotlib.testing.decorators import check_figures_equal, skipif_font_missing
 import matplotlib.font_manager as fm
 import matplotlib.pyplot as plt
 
@@ -55,15 +55,14 @@ def test_fallback_smoke():
         fig.savefig(io.BytesIO(), format=fmt)
 
 
+@skipif_font_missing(['WenQuanYi Zen Hei', 'Noto Sans CJK JP'])
 @pytest.mark.parametrize('family_name, file_name',
                          [("WenQuanYi Zen Hei",  "wqy-zenhei"),
                           ("Noto Sans CJK JP", "NotoSansCJK")]
                          )
 @check_figures_equal(extensions=["png", "pdf", "eps", "svg"])
 def test_font_fallback_chinese(fig_test, fig_ref, family_name, file_name):
     fp = fm.FontProperties(family=[family_name])
-    if file_name not in Path(fm.findfont(fp)).name:
-        pytest.skip(f"Font {family_name} ({file_name}) is missing")
 
     text = ["There are", "几个汉字", "in between!"]
 
@@ -78,6 +77,7 @@ def test_font_fallback_chinese(fig_test, fig_ref, family_name, file_name):
         fig_test.text(0.05, .85 - 0.15*j, txt, family=test_font)
 
 
+@skipif_font_missing(['WenQuanYi Zen Hei', 'Noto Sans CJK JP'])
 @pytest.mark.parametrize(
     "family_name, file_name",
     [
@@ -88,8 +88,6 @@ def test_font_fallback_chinese(fig_test, fig_ref, family_name, file_name):
 def test__get_fontmap(family_name, file_name):
     fp = fm.FontProperties(family=[family_name])
     found_file_name = Path(fm.findfont(fp)).name
-    if file_name not in found_file_name:
-        pytest.skip(f"Font {family_name} ({file_name}) is missing")
 
     text = "There are 几个汉字 in between!"
     ft = fm.get_font(