From e1ea522f706ac51f4bdd6b58724af56eebd19d66 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 31 Dec 2023 13:21:56 +0100
Subject: [PATCH] =?UTF-8?q?=EF=BB=BFAdded=20further=20type=20hints?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/PIL/Image.py           |  6 +++---
 src/PIL/IptcImagePlugin.py | 15 ++++++++-------
 2 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 613d9462a60..055dbda7a03 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3190,7 +3190,7 @@ def _decompression_bomb_check(size):
         )
 
 
-def open(fp, mode="r", formats=None):
+def open(fp, mode="r", formats=None) -> Image:
     """
     Opens and identifies the given image file.
 
@@ -3415,7 +3415,7 @@ def merge(mode, bands):
 # Plugin registry
 
 
-def register_open(id, factory, accept=None):
+def register_open(id, factory, accept=None) -> None:
     """
     Register an image file plugin.  This function should not be used
     in application code.
@@ -3469,7 +3469,7 @@ def register_save_all(id, driver):
     SAVE_ALL[id.upper()] = driver
 
 
-def register_extension(id, extension):
+def register_extension(id, extension) -> None:
     """
     Registers an image extension.  This function should not be
     used in application code.
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index faf3ed936f3..2314ddce892 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -18,6 +18,7 @@
 
 import os
 import tempfile
+from typing import Sequence
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -27,7 +28,7 @@
 COMPRESSION = {1: "raw", 5: "jpeg"}
 
 
-def __getattr__(name):
+def __getattr__(name: str) -> bytes:
     if name == "PAD":
         deprecate("IptcImagePlugin.PAD", 12)
         return b"\0\0\0\0"
@@ -39,7 +40,7 @@ def __getattr__(name):
 # Helpers
 
 
-def _i(c):
+def _i(c: bytes) -> int:
     return i32((b"\0\0\0\0" + c)[-4:])
 
 
@@ -47,13 +48,13 @@ def _i8(c: int | bytes) -> int:
     return c if isinstance(c, int) else c[0]
 
 
-def i(c):
+def i(c: bytes) -> int:
     """.. deprecated:: 10.2.0"""
     deprecate("IptcImagePlugin.i", 12)
     return _i(c)
 
 
-def dump(c):
+def dump(c: Sequence[int | bytes]) -> None:
     """.. deprecated:: 10.2.0"""
     deprecate("IptcImagePlugin.dump", 12)
     for i in c:
@@ -70,10 +71,10 @@ class IptcImageFile(ImageFile.ImageFile):
     format = "IPTC"
     format_description = "IPTC/NAA"
 
-    def getint(self, key):
+    def getint(self, key: tuple[int, int]) -> int:
         return _i(self.info[key])
 
-    def field(self):
+    def field(self) -> tuple[tuple[int, int] | None, int]:
         #
         # get a IPTC field header
         s = self.fp.read(5)
@@ -101,7 +102,7 @@ def field(self):
 
         return tag, size
 
-    def _open(self):
+    def _open(self) -> None:
         # load descriptive fields
         while True:
             offset = self.fp.tell()