Add some type hints

myzhang1029 · myzhang1029 · commit f0cee2f5718a · 2026-06-06T16:49:15.000-04:00
diff --git a/lib/matplotlib/backends/backend_pdf.pyi b/lib/matplotlib/backends/backend_pdf.pyi
@@ -1,4 +1,5 @@
 import os
+import types
 from datetime import datetime
 from enum import Enum
 from functools import total_ordering
@@ -9,7 +10,9 @@ from _typeshed import ReadableBuffer, SupportsWrite
 
 from matplotlib import _api
 from matplotlib.backend_bases import FigureCanvasBase, GraphicsContextBase
+from matplotlib.dviread import DviFont
 from matplotlib.figure import Figure
+from matplotlib.font_manager import FontPath
 from matplotlib.transforms import BboxBase
 
 from . import _backend_pdf_ps
@@ -104,9 +107,16 @@ class Op(Enum):
     def paint_path(cls, fill: bool, stroke: bool) -> bytes: ...
 
 class Stream:
-    def __init__(self, id, len, file, extra=None, png=None): ...
-    def end(self): ...
-    def write(self, data): ...
+    def __init__(
+        self,
+        id: int,
+        len: Reference | None,
+        file: PdfFile,
+        extra: dict[Name, Any] | None = None,
+        png: dict[Any, Any] | None = None,
+    ) -> None: ...
+    def end(self) -> None: ...
+    def write(self, data: bytes) -> None: ...
 
 class PdfFile:
     def __init__(
@@ -115,7 +125,7 @@ class PdfFile:
         metadata: _MetadataDict | None = None,
     ) -> None: ...
     @property
-    def dviFontInfo(self): ...
+    def dviFontInfo(self) -> dict[Name, types.SimpleNamespace]: ...
     def newPage(self, width: float, height: float) -> None: ...
     def newTextnote(
         self,
@@ -125,12 +135,20 @@ class PdfFile:
     def finalize(self) -> None: ...
     def write(self, data: ReadableBuffer) -> None: ...
     def output(self, *data: _SupportsPdfReprExt) -> None: ...
-    def beginStream(self, id, len, extra=None, png=None): ...
-    def endStream(self): ...
-    def outputStream(self, ref, data, *, extra=None): ...
-    def fontName(self, fontprop, subset=0): ...
-    def dviFontName(self, dvifont): ...
-    def writeFonts(self): ...
+    def beginStream(
+        self,
+        id: int,
+        len: Reference | None,
+        extra: dict[Name, Any] | None = None,
+        png: dict[Any, Any] | None = None,
+    ) -> None: ...
+    def endStream(self) -> None: ...
+    def outputStream(
+        self, ref: Reference, data: bytes, *, extra: dict[Name, Any] | None = None
+    ) -> None: ...
+    def fontName(self, fontprop: FontPath | str, subset: int = 0) -> Name | None: ...
+    def dviFontName(self, dvifont: DviFont) -> Name: ...
+    def writeFonts(self) -> None: ...
     @_api.delete_parameter("3.11", "fontfile")
     def createType1Descriptor(self, t1font, fontfile=None): ...
     def embedTTF(self, filename, subset_index, charmap): ...
@@ -158,7 +176,7 @@ class PdfFile:
 
 class RendererPdf(_backend_pdf_ps.RendererPDFPSBase):
     def __init__(self, file, image_dpi, height, width): ...
-    def finalize(self): ...
+    def finalize(self) -> None: ...
     def check_gc(self, gc, fillcolor=None): ...
     def get_image_magnification(self): ...
     def draw_image(self, gc, x, y, im, transform=None): ...
@@ -210,7 +228,7 @@ class GraphicsContextPdf(GraphicsContextBase):
     def clip_cmd(self, cliprect, clippath): ...
     def delta(self, other): ...
     def copy_properties(self, other): ...
-    def finalize(self): ...
+    def finalize(self) -> None: ...
 
 class PdfPages:
     def __init__(
