test(docs[sphinx_fonts]): add tests for sphinx_fonts extension

why: codecov drops because docs/_ext/sphinx_fonts.py is measured for coverage but has zero tests across all repos. what: - Add test_sphinx_fonts.py with 21 tests covering all functions - Add test infrastructure (conftest, __init__) for docs/_ext tests - Test pure functions, I/O with monkeypatch, Sphinx events with SimpleNamespace - Cover all branches: cached/success/URLError/OSError, html/non-html, empty/with fonts
vcs-python · tony · Mar 14, 2026 · Mar 14, 2026 · Mar 14, 2026 · Mar 14, 2026
commit 09b5b2ffb6a1ed2786292f2f1bbf9236c9c2733a
diff --git a/docs/_ext/conftest.py b/docs/_ext/conftest.py
@@ -0,0 +1,10 @@
+"""Pytest configuration for docs/_ext doctests."""
+
+from __future__ import annotations
+
+import pathlib
+import sys
+
+_ext_dir = pathlib.Path(__file__).parent
+if str(_ext_dir) not in sys.path:
+    sys.path.insert(0, str(_ext_dir))
diff --git a/tests/docs/__init__.py b/tests/docs/__init__.py
@@ -0,0 +1,3 @@
+"""Tests for documentation extensions."""
+
+from __future__ import annotations
diff --git a/tests/docs/_ext/__init__.py b/tests/docs/_ext/__init__.py
@@ -0,0 +1,3 @@
+"""Tests for docs/_ext Sphinx extensions."""
+
+from __future__ import annotations
diff --git a/tests/docs/_ext/conftest.py b/tests/docs/_ext/conftest.py
@@ -0,0 +1,10 @@
+"""Fixtures and configuration for docs extension tests."""
+
+from __future__ import annotations
+
+import pathlib
+import sys
+
+docs_ext_path = pathlib.Path(__file__).parent.parent.parent.parent / "docs" / "_ext"
+if str(docs_ext_path) not in sys.path:
+    sys.path.insert(0, str(docs_ext_path))
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		"""Tests for documentation extensions."""

		from __future__ import annotations
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		"""Tests for docs/_ext Sphinx extensions."""

		from __future__ import annotations